{"uid":"cap_22cMIAJbTJ_YYIvGUb4f0","slug":"blockscout-nft-token-instance-lookup-f5b8789f","name":"Blockscout NFT Token Instance Lookup","description":"Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data","url":"https://api.blockscout.com/%7Bchain_id%7D/api/v2/tokens/%7Baddress_hash_param%7D/instances/%7Btoken_id_param%7D","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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","properties":{"chain_id":{"type":"string"},"token_id_param":{"type":"string"},"address_hash_param":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"id":"string","owner":{},"token":{},"value":"string","metadata":{},"image_url":"string","is_unique":true,"media_url":"string","media_type":"string","thumbnails":{"60x60":"string","250x250":"string","500x500":"string","original":"string"},"token_type":{},"animation_url":"string","external_app_url":"string","image_media_type":"string","animation_media_type":"string"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PeAmjVHp3DljkjVePSGMb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves detailed metadata and media information for a specific NFT token instance (by token ID) on a given blockchain network via Blockscout's multichain explorer API","exampleAgentPrompt":"Can you pull up the full NFT details for token ID 42 on the contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum (chain ID 1) using Blockscout? I want to see the image, owner, media type, and any animation.","exampleUseCases":[{"title":"NFT Ownership and Provenance Check","prompt":"Who currently owns token ID 7804 on the Bored Ape Yacht Club contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum? Use Blockscout to pull the full instance details."},{"title":"NFT Media and Metadata Retrieval","prompt":"I need the image URL, thumbnail, animation URL, and metadata for token ID 1 on contract 0x60E4d786628Fea6478F785A6d7e704777c86a7c6 on Ethereum via Blockscout — I'm building a display card for this NFT."},{"title":"Cross-Chain NFT Inspection","prompt":"Can you look up token ID 500 on the NFT contract 0xabcdef1234567890abcdef1234567890abcdef12 deployed on Polygon (chain ID 137) via Blockscout and tell me the media type and whether it's a unique instance?"}],"resultDescription":"Returns a JSON object for the specific NFT token instance including: token ID, owner details, parent token metadata, value, full metadata object, image URL, image media type, media URL, media type, thumbnail URLs at multiple resolutions (60x60, 250x250, 500x500, original), token type, animation URL, animation media type, and external app URL.","failureModes":["Invalid or unsupported chain_id returns 404 or empty response","Non-existent token ID for a given contract returns 404 not found","Invalid contract address format returns 400 bad request","Contract address is not an NFT contract — returns error or empty data","Token has no on-chain metadata — returns partial response with null fields","Rate limiting or payment failure (x402) blocks the request"],"whenToPreferThis":"Use this endpoint when you need rich, structured metadata for a specific NFT token instance — including media URLs, thumbnails, owner, and animation — across any EVM-compatible chain supported by Blockscout. Prefer it over generic blockchain RPC calls when you want parsed, human-readable NFT data without decoding raw on-chain responses. Best when you know both the contract address and the specific token ID and want multichain support in a single API surface.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-11T18:56:50.878Z","isFirstParty":false}