Ranked list of tokens by swap activity and adoption velocity, with optional Farcaster personalization.
What it does
The Zapper Token Ranking endpoint returns a paginated, ranked list of tokens ordered by swap activity and velocity of adoption across 60+ chains. Each result includes the token's address, chain ID, buy count, buyer count (total and 24h), and rich price data: current price, 5-minute/1-hour/24-hour price changes, total liquidity, 24h volume, and market cap. The response also includes the latest swaps (with ENS-resolved addresses) and latest Farcaster swaps (with usernames and USD volume). An optional Farcaster ID (FID) parameter personalizes the ranking for a specific user.
This is one of 16+ paid tools in the Zapper x402 API suite. Payment is via x402 protocol using USDC on Base (chain 8453). Each call costs 4,500 base units of USDC (6 decimals), which equals $0.0045 per request. The endpoint accepts POST requests with a JSON body containing optional `first` (pagination limit, default 10), `after` (cursor), and `fid` (Farcaster ID) parameters. No required fields — an empty body or `{"first": 10}` returns the default top-10 ranking.
The endpoint is live, returning a proper 402 payment challenge. The OpenAPI spec (v3.1.0) provides full input/output schemas including the Bazaar extension with example bodies and detailed output structure. Pagination is cursor-based with `pageInfo.hasNextPage` and `pageInfo.endCursor`.
Capabilities
Use cases
- —Build a trending tokens dashboard ranked by real swap activity rather than market cap alone
- —Power an AI agent that recommends tokens based on adoption velocity and social (Farcaster) signals
- —Monitor which tokens are gaining the most new buyers in the last 24 hours
- —Create personalized token discovery feeds for Farcaster users
- —Backfill analytics pipelines with swap-based token momentum data
Fit
Best for
- —Agents and apps needing real-time token trend data ranked by on-chain swap activity
- —Farcaster-integrated products wanting personalized token rankings
- —DeFi dashboards that need buyer counts, price changes, and latest swap details in one call
Not for
- —Historical time-series price charting (use the historical-token-price endpoint instead)
- —Portfolio balance lookups for specific wallets (use token-balances or portfolio-totals)
- —Non-EVM chains or tokens not tracked by Zapper
Quick start
curl -X POST https://public.zapper.xyz/x402/token-ranking \
-H 'Content-Type: application/json' \
-H 'X-Payment: <x402-payment-token>' \
-d '{"first": 10}'Example
Request
{
"fid": 3,
"first": 10
}Response
{
"data": {
"tokenRanking": {
"edges": [
{
"node": {
"id": "ranking-1",
"token": {
"name": "USD Coin",
"symbol": "USDC",
"address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"priceData": {
"price": 1.0001,
"marketCap": 35000000000,
"volume24h": 120000000,
"priceChange1h": 0.0001,
"priceChange5m": 0,
"priceChange24h": -0.0002,
"totalLiquidity": 500000000
},
"imageUrlV2": "https://..."
},
"chainId": 8453,
"buyCount": 5420,
"buyerCount": 3100,
"tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"buyerCount24h": 412
},
"cursor": "abc100"
}
],
"pageInfo": {
"endCursor": "abc123",
"hasNextPage": true
}
}
}
}Endpoint
Quality
Full OpenAPI 3.1.0 schema with detailed input/output structure, live 402 challenge confirming the endpoint is operational, clear pricing ($0.0045/call in Base USDC), and Bazaar extensions with example bodies. Docked slightly because no actual 200 response example was captured and the crawled docs pages returned 404s (the legacy API docs at /api are deprecated).
Warnings
- —The legacy Zapper REST API at /api is deprecated; the x402 endpoints at /x402/* are the current offering.
- —Crawled /docs, /pricing, and /README all returned 404; documentation lives in the OpenAPI spec and at build.zapper.xyz.
Citations
- —Enterprise grade onchain data across 60+ chains — token prices, NFTs, portfolios, transactions, and more.https://public.zapper.xyz/x402/token-ranking
- —Price per call is 4500 base units of USDC on Base (chain 8453), i.e. $0.0045https://public.zapper.xyz/x402/token-ranking
- —The endpoint returns a ranked list of tokens based on swap activity and velocity of adoption, optionally tailored for a farcaster user.https://public.zapper.xyz/x402/token-ranking
- —The legacy Zapper API is deprecated; users should visit build.zapper.xyzhttps://public.zapper.xyz/api