Get NFT collection metadata including market stats, holders, events, and sample NFTs via Zapper's onchain data API.
What it does
This endpoint returns comprehensive NFT collection data from Zapper's onchain data platform. Given one or more collection contract addresses and chain IDs, it returns collection name, network, floor price (in USD), market cap, holder count, a paginated list of NFTs in the collection, recent collection events, and top holders. It supports collections across 60+ chains.
The endpoint is part of Zapper's x402-enabled API suite. Payment is $0.001125 per request, settled in USDC on Base (chain 8453) via the x402 protocol. The request body accepts a `collections` array, where each entry specifies an `address` (the 0x contract address) and a `chainId` (e.g., 8453 for Base, 1 for Ethereum mainnet). Multiple collections can be queried in a single call.
The response wraps data under `nftCollectionsV2`, returning an array of collection objects. Each object includes fields like `name`, `address`, `network`, `floorPrice.valueUsd`, `marketCap`, `holdersCount`, plus nested `nfts`, `events`, and `holders` objects. This endpoint is live and returns a valid x402 payment challenge (HTTP 402) when called without payment.
Capabilities
Use cases
- —Retrieve floor price and market cap for an NFT collection before making a purchase decision
- —Build a dashboard showing holder distribution and recent events for multiple NFT collections
- —Monitor NFT collection stats across multiple chains in an automated agent workflow
- —Enrich NFT collection data in a portfolio tracker with holder counts and sample NFTs
- —Compare market stats across several NFT collections in a single batched request
Fit
Best for
- —Agents needing structured NFT collection market data across 60+ chains
- —Portfolio and analytics tools requiring floor price, market cap, and holder data
- —Developers building NFT dashboards who want pay-per-call pricing without API keys
Not for
- —Fetching metadata for individual NFT tokens (use nft-token-metadata instead)
- —Free or high-volume bulk scraping of NFT data (each call costs $0.001125)
- —Non-EVM chains or collections not indexed by Zapper
Quick start
curl -X POST https://public.zapper.xyz/x402/nft-collection-metadata \
-H "Content-Type: application/json" \
-H "X-Payment: <x402-payment-token>" \
-d '{"collections":[{"address":"0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd","chainId":8453}]}'Example
Request
{
"collections": [
{
"address": "0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd",
"chainId": 8453
}
]
}Response
{
"data": {
"nftCollectionsV2": [
{
"name": "Example Collection",
"nfts": {},
"events": {},
"address": "0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd",
"holders": {},
"network": "BASE_MAINNET",
"marketCap": 125000,
"floorPrice": {
"valueUsd": 12.5
},
"holdersCount": 4200
}
]
}
}Endpoint
Quality
Full OpenAPI schema with input/output descriptions, live 402 challenge captured, clear pricing, and example request body are all present. Docked slightly because no actual 200 response example is available (output schema is illustrative only) and crawled docs pages returned 404s.
Warnings
- —The legacy Zapper API at /api is marked with a deprecation notice pointing to build.zapper.xyz; the x402 endpoints appear to be the current offering.
- —No actual 200 response body was captured; the output schema is inferred from the Bazaar extension's example structure.
- —Crawled /docs, /pricing, and /README all returned 404; documentation is only available via the OpenAPI spec.
Citations
- —Endpoint price is $0.001125 per call (1125 base units of USDC with 6 decimals on Base chain 8453)https://public.zapper.xyz/x402/nft-collection-metadata
- —Zapper API covers 60+ chains for onchain data including token prices, NFTs, portfolios, and transactionshttps://public.zapper.xyz/x402/nft-collection-metadata
- —The legacy Zapper API has a deprecation notice directing users to build.zapper.xyzhttps://public.zapper.xyz/api
- —Payment is settled in USDC on Base (asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, network eip155:8453)https://public.zapper.xyz/x402/nft-collection-metadata