{"uid":"cap_xI0hsnPfs1XwPMziJjy_o","slug":"zerion-api-get-nft-by-id-dfd0c498","name":"Zerion API - Get NFT by ID","description":"Interpreted wallet data for more than 40 chains and Solana: portfolios, DeFi positions, PnL, transactions and NFTs. REST for apps, x402 pay-per-call for agents.","url":"https://api.zerion.io/v1/nfts/%7Bnft_id%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["nft_id"],"properties":{"nft_id":{"type":"string","description":"NFT ID in format chain:contract:token_id"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data"],"properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Resource ID."},"type":{"type":"string","description":"Resource type."},"attributes":{"type":"object","description":"Resource attributes; see https://developers.zerion.io"}}},"links":{"type":"object","description":"Self and pagination links."}}}}}}},"responseSchema":{"type":"json","example":{"data":{"id":"<resource id>","type":"<resource type>","attributes":{}},"links":{"self":"https://api.zerion.io/v1/..."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ww__ucDreH8fU25S9Enr5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches detailed metadata and attributes for a single NFT identified by chain, contract address, and token ID","exampleAgentPrompt":"Can you pull up the full details for the NFT at contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D token #1234 on Ethereum?","exampleUseCases":[{"title":"NFT portfolio display enrichment","prompt":"I have an NFT with ID ethereum:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D:1234 — can you fetch its metadata from Zerion so I can display it in my portfolio app?"},{"title":"Verify NFT authenticity and attributes","prompt":"Can you look up the NFT at polygon:0x2953399124F0cBB46d2CbACD8A89cF0599974963:5678 on Zerion and tell me its attributes and whether it's a verified collection?"},{"title":"Cross-chain NFT research","prompt":"I'm trying to research this Solana NFT — its ID is solana:So11111111111111111111111111111111111111112:99. Can you get the full details for it from Zerion?"}],"resultDescription":"A JSON object with a data field containing the NFT's resource ID, resource type, and attributes (metadata specific to that NFT such as name, image, traits, collection info), plus a links object with a self-referencing URL to the resource on the Zerion API.","failureModes":["Invalid NFT ID format (must be chain:contract:token_id) returns 400 Bad Request","NFT not found or not indexed by Zerion returns 404 Not Found","Insufficient USDC balance for x402 pay-per-call returns 402 Payment Required","Unsupported chain identifier returns 400 or 404","Rate limiting or overload returns 429 Too Many Requests"],"whenToPreferThis":"Use this endpoint when you need detailed metadata for a single, known NFT and you have its exact chain, contract address, and token ID. It is ideal for agents that need to display, verify, or analyze a specific NFT rather than searching or listing collections. Prefer this over the search/list NFT endpoint when the full NFT ID is already known and you need structured attribute data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-29T18:43:36.713Z","isFirstParty":false,"canonicalSlug":"zerion-api-get-nft-by-id-dfd0c498"}