api.slamai.dev · exotic

Retrieves token price details including FDV, liquidity, and 24-hour change, quoted in any ERC20 or major blockchain token.

Call it in 30 seconds

// npm i x402-fetch viem
import { wrapFetchWithPayment } from "x402-fetch";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount(process.env.PRIVATE_KEY); // funds USDC on Base
const wallet = createWalletClient({ account, chain: base, transport: http() });
const fetchWithPay = wrapFetchWithPayment(fetch, wallet);

// Pays the $0.001 USDC automatically on the 402, then returns the real response:
const res = await fetchWithPay("https://api.slamai.dev/token/price/exotic", { method: "GET" });
console.log(await res.json());

# pip install x402 eth-account httpx
import os, asyncio
from eth_account import Account
from x402.clients.httpx import x402HttpxClient

account = Account.from_key(os.environ["PRIVATE_KEY"])  # funds USDC on Base

async def main():
    async with x402HttpxClient(account=account) as client:
        # x402 handles the 402 -> pay ($0.001 USDC) -> retry automatically
        r = await client.get("https://api.slamai.dev/token/price/exotic")
        print((await r.aread()).decode())

asyncio.run(main())

# 1) An unpaid request returns HTTP 402 with the exact payment terms:
curl -i "https://api.slamai.dev/token/price/exotic?addresses={'description': 'Pipe-delimited token addresses. Max: 30. E.g. 0x123...|0x456...', 'type': 'string'}&blockchain={'description': 'The blockchain network to query.', 'enum': ['ethereum', 'base'], 'required': True, 'type': 'string'}&estimate_cost={'description': 'Return only SLAM token cost for this query', 'type': 'boolean'}&quote_address={'description': 'The contract address of the token to use for price output. Any ERC20 token address is supported.', 'type': 'string'}&quote_symbol={'description': 'The quote token to use for price output. Any ERC20 token symbol and many major tokens on other blockchains are supported. When multiple tokens have the same symbol, the system chooses the most active token with that symbol over the last 24 hours. Example: BRETT', 'type': 'string'}&symbols={'description': 'A pipe-delimited list of token symbols to query. When multiple tokens have the same symbol, the system chooses the most active token with that symbol over the last 24 hours. Example: SWARM|VADER Maximum: 30 symbols', 'type': 'string'}"

# 2) Paying + retrying requires an x402 client that can sign the USDC
#    authorization (curl alone cannot). See the JS / Python tabs below.

New to x402? Read the 5-minute quickstart →