Get detailed NFT metadata, traits, media, and holder info for a specific token via x402 payment.
What it does
The Zapper NFT Token Metadata endpoint returns comprehensive data about a specific NFT given its collection address, chain ID, and token ID. The response includes the token's name, description, traits (attribute name/value pairs), media assets (images, animations, audio), collection-level data (name, symbol, floor price), current holders, estimated USD value, and last sale price.
This is one of 17 paid tools in the Zapper API suite, which provides onchain data across 60+ chains. The endpoint accepts POST requests with a JSON body and is gated via the x402 payment protocol. Each call costs 1,125 base units of USDC on Base (chain 8453), which equals $0.001125. Payment is also supported via MPP (Tempo). The endpoint returns structured JSON under a `nftTokenV2` key.
The API is part of Zapper's broader offering that includes token prices, portfolio balances, DeFi positions, transaction history, NFT balances, search, rankings, and social identity resolution. The OpenAPI spec is well-documented with full request/response schemas and example payloads for each tool.
Capabilities
Use cases
- —Retrieve traits and rarity attributes for a specific NFT to display in a marketplace or portfolio UI
- —Look up estimated USD value and last sale price for an NFT before making a purchase decision
- —Fetch media URLs (images, animations, audio) for rendering NFT previews in an application
- —Identify current holders of a specific NFT token
- —Enrich an agent's knowledge about a particular NFT during a conversational workflow
Fit
Best for
- —Agents or apps that need per-token NFT metadata across 60+ EVM chains
- —Programmatic NFT valuation and trait analysis
- —Building NFT gallery or portfolio display features
Not for
- —Bulk enumeration of all tokens in a collection (use nft-collection-metadata instead)
- —Non-EVM chains or off-chain NFT standards
- —Free/unauthenticated access — every call requires x402 or MPP payment
Quick start
curl -X POST https://public.zapper.xyz/x402/nft-token-metadata \
-H "Content-Type: application/json" \
-H "X-Payment: <x402-payment-token>" \
-d '{"collectionAddress":"0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd","chainId":8453,"tokenId":"1"}'Example
Request
{
"chainId": 8453,
"tokenId": "1",
"collectionAddress": "0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd"
}Response
{
"data": {
"nftTokenV2": {
"id": "base-0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd-1",
"name": "Example NFT #1",
"traits": [
{
"attributeName": "Background",
"attributeValue": "Blue"
},
{
"attributeName": "Rarity",
"attributeValue": "Rare"
}
],
"holders": {},
"tokenId": "1",
"lastSale": {
"valueUsd": 10
},
"mediasV3": {
"audios": {},
"images": {},
"animations": {}
},
"collection": {
"name": "Example Collection",
"symbol": "EXC",
"floorPrice": {
"valueUsd": 12.5
}
},
"description": "An example NFT token.",
"estimatedValue": {
"valueUsd": 15
}
}
}
}Endpoint
Quality
Full OpenAPI schema with input/output definitions and a live 402 challenge confirming the endpoint is operational. Price is clear ($0.001125 USDC per call on Base). Response schema is provided as an example structure rather than a strict JSON Schema, and no actual 200 response sample was captured, so some output fields are inferred from the schema examples.
Warnings
- —The legacy Zapper API at /api shows a deprecation notice pointing to build.zapper.xyz; the x402 endpoints appear to be the current offering.
- —Response example is inferred from the output schema — no actual 200 response body was captured in the probe.
Citations
- —Endpoint costs 1,125 base units of USDC on Base (chain 8453), i.e. $0.001125 per callhttps://public.zapper.xyz/x402/nft-token-metadata
- —Zapper API provides onchain data across 60+ chains — token prices, NFTs, portfolios, transactions, and morehttps://public.zapper.xyz/x402/nft-token-metadata
- —The legacy Zapper API shows a deprecation notice directing users to build.zapper.xyzhttps://public.zapper.xyz/api
- —Required request fields are collectionAddress, chainId, and tokenIdhttps://public.zapper.xyz/x402/nft-token-metadata
- —Response includes nftTokenV2 with traits, mediasV3, holders, estimatedValue, lastSale, and collection datahttps://public.zapper.xyz/x402/nft-token-metadata