Ranked NFT collections by trading activity and popularity, with optional Farcaster personalization.
What it does
The Zapper NFT Ranking endpoint returns a paginated, ranked list of NFT collections ordered by trading activity and collection popularity. It is part of Zapper's broader onchain data API suite covering 60+ chains. The ranking can optionally be personalized for a specific Farcaster user by passing their FID.
Each result includes the collection address, chain ID, collection name, description, floor price (USD), top offer price, volume stats (hourly, daily, monthly, total), network info, and logo media. The response uses cursor-based pagination, so callers can page through the full ranking. The endpoint accepts a POST with a JSON body containing optional `first` (default 10), `after` (cursor), and `fid` (Farcaster ID) parameters.
Payment is via x402 on Base using USDC at $0.0045 per call (4500 base units, 6 decimals). The endpoint is live and returns a 402 challenge to unauthenticated callers. Zapper also supports MPP as an alternative payment protocol for this tool.
Capabilities
Use cases
- —Discover trending NFT collections ranked by recent trading volume
- —Build dashboards showing top NFT collections across multiple chains
- —Personalize NFT recommendations for Farcaster users
- —Monitor NFT market activity for trading bots or alerts
- —Aggregate collection-level stats (floor price, volume, top offer) for analytics
Fit
Best for
- —Agents or apps that need a ranked feed of popular NFT collections
- —Farcaster-integrated tools wanting personalized NFT discovery
- —Multi-chain NFT market monitoring and analytics
Not for
- —Fetching metadata or traits for individual NFT tokens (use nft-token-metadata instead)
- —Looking up wallet-level NFT holdings (use nft-balances instead)
- —Non-blockchain or non-NFT use cases
Quick start
curl -X POST https://public.zapper.xyz/x402/nft-ranking \
-H "Content-Type: application/json" \
-H "X-Payment: <x402-payment-token>" \
-d '{"first": 5}'Example
Request
{
"fid": 3,
"first": 10
}Response
{
"data": {
"nftRanking": {
"edges": [
{
"node": {
"id": "ranking-1",
"chainId": 1,
"collection": {
"name": "Bored Ape Yacht Club",
"stats": {
"dailyVolume": {
"valueUsd": 1200000
},
"totalVolume": {
"valueUsd": 2800000000
},
"hourlyVolume": {
"valueUsd": 85000
},
"monthlyVolume": {
"valueUsd": 35000000
}
},
"medias": {
"logo": {
"original": "https://example.com/bayc-logo.png"
}
},
"networkV2": {
"name": "Ethereum Mainnet",
"chainId": 1
},
"floorPrice": {
"valueUsd": 42000
},
"description": "A collection of 10,000 unique apes.",
"topOfferPrice": {
"valueUsd": 41500
}
},
"collectionAddress": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
},
"cursor": "abc100"
}
],
"pageInfo": {
"endCursor": "abc123",
"hasNextPage": true
}
}
}
}Endpoint
Quality
Full OpenAPI schema with input/output definitions and a live 402 challenge confirming the endpoint is operational. Pricing is clear ($0.0045 USDC per call on Base). Docs for the legacy v2 API exist but the x402 endpoints lack dedicated documentation pages, so some details are inferred from the schema alone.
Warnings
- —The legacy Zapper v2 API at /api shows a deprecation notice directing users to build.zapper.xyz; the x402 endpoints appear to be the replacement but lack standalone documentation.
- —No dedicated docs page was found for x402 endpoints (/docs returns 404).
Citations
- —Endpoint returns a ranked list of NFT collections based on trading activity and collection popularity, optionally tailored for a Farcaster user.https://public.zapper.xyz/x402/nft-ranking
- —Price is 4500 base units of USDC on Base (eip155:8453), which equals $0.0045 per call.https://public.zapper.xyz/x402/nft-ranking
- —Zapper API covers 60+ chains with token prices, NFTs, portfolios, transactions, and more.https://public.zapper.xyz/api
- —The legacy v2 API shows a deprecation notice directing to build.zapper.xyz.https://public.zapper.xyz/api