Top tokens by market cap with price, volume, and supply data via Bitquery, paid per-call with USDC on Base, Solana, or Lightning.
What it does
This endpoint returns top-performing tokens ranked by market cap, including price, volume, and supply metrics. It is part of the Einstein AI x402 API suite, which wraps Bitquery blockchain data behind x402 micropayment gates. The `/raw` variant returns structured JSON data without AI-generated analysis.
The endpoint accepts POST requests with optional parameters for chain selection (base, ethereum, bsc, arbitrum, polygon, optimism, solana) and result limit (1–500, default 50). Payment is $0.40 per request, settled in USDC on Base (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913), USDC on Solana, or 524 sats via Lightning Network. No API keys are required; authentication is handled entirely through the x402 payment header.
The broader Einstein AI platform at emc2ai.io offers over 20 x402 endpoints covering market analysis, whale intelligence, launchpad tracking (Pump.fun, Zora), security audits (rug pull scanning, MEV detection), DeFi arbitrage scanning, and a general-purpose AI agent endpoint. Prices across the suite range from $0.25 to $1.15 per call. The endpoint is live and returning a valid x402 challenge with version 1, scheme "exact", and a 90-second timeout.
Capabilities
Use cases
- —Ranking tokens by market cap across multiple EVM chains and Solana
- —Building dashboards that display top-performing tokens with price and volume
- —Feeding structured token market data into trading bots or AI agents
- —Comparing token supply metrics across chains for portfolio analysis
- —Automated market screening for tokens meeting volume or cap thresholds
Fit
Best for
- —AI agents needing structured multi-chain token market data without API key management
- —Pay-per-use access to Bitquery data without a Bitquery subscription
- —Developers building cross-chain token ranking features with micropayment settlement
Not for
- —High-frequency trading requiring sub-second latency (90s timeout window)
- —Historical time-series analysis requiring granular OHLCV data (use the /ohlcv endpoint instead)
- —Free or bulk data access — every call costs $0.40
Quick start
curl -X POST https://emc2ai.io/x402/bitquery/top-tokens/raw \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <base64-encoded-signed-USDC-authorization>" \
-d '{"chain": "base", "limit": 10}'Example
Request
{
"chain": "base",
"limit": 10
}Response
{
"result": {
"tokens": [
{
"name": "ExampleToken",
"price": 1.23,
"symbol": "EXT",
"address": "0xabc...def",
"marketCap": 52000000,
"volume24h": 8500000,
"totalSupply": 42000000
}
]
},
"status": "completed",
"payment": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "400000",
"scheme": "exact",
"txHash": "0x123...abc",
"network": "base",
"x402Version": 1
}
}Endpoint
Quality
Full OpenAPI schema with detailed request/response models, live x402 challenge captured on three payment networks, clear pricing ($0.40 USDC), and documented input fields. Deducted because no actual 200 response example is available from the probe (only the 402 challenge), and the /raw variant is not explicitly listed in the OpenAPI paths (only /top-tokens is), so the exact response shape is inferred from the generic BitqueryResponse schema.
Warnings
- —The /top-tokens/raw path is not explicitly listed in the OpenAPI spec; only /top-tokens is. The /raw suffix likely returns data without AI analysis, but the exact response schema is inferred.
- —The /api route returned a 522 (host error) during crawl, suggesting occasional origin server instability.
- —Example response JSON is inferred from the BitqueryResponse schema — no actual 200 response was captured.
Citations
- —Endpoint returns x402 challenge with maxAmountRequired 400000 (=$0.40 USDC) on Base, Solana, and Lightninghttps://emc2ai.io/x402/bitquery/top-tokens/raw
- —Supported chains include base, ethereum, bsc, arbitrum, polygon, optimism, solana with limit 1-500https://emc2ai.io
- —USDC asset address on Base is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 with 6 decimalshttps://emc2ai.io
- —Einstein accepts payments on three chains: USDC on Base, USDC on Solana, and BTC via Lightning Networkhttps://emc2ai.io/docs
- —x402 API prices range from $0.25 to $1.15 across the suitehttps://emc2ai.io