{"uid":"cap_kyEUnGkmZ8FDSLFfc4IO5","slug":"blockscout-nft-token-instances-by-contract-5389eaa5","name":"Blockscout NFT Token Instances by Contract","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","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"},"address_hash_param":{"type":"string"}}},"queryParams":{"type":"object","properties":{"items_count":{"type":"integer"},"unique_token":{"type":"string"},"holder_address_hash":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"id":"string","owner":{},"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":"string","animation_url":"string","external_app_url":"string","image_media_type":"string","animation_media_type":"string"}],"next_page_params":{}}},"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_6Si7W7-lWvG_PgAe26-5O","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":"Returns paginated NFT instances (with metadata, media URLs, and ownership) for a given token contract address on a specified blockchain network","exampleAgentPrompt":"Show me all NFT instances minted under the token contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum mainnet, including their images and metadata.","exampleUseCases":[{"title":"Browse NFTs in a collection","prompt":"Can you list all the NFT instances for the Bored Ape Yacht Club contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum and show me their thumbnails and metadata?"},{"title":"Check NFTs held by a wallet in a contract","prompt":"Which NFTs from the contract 0x495f947276749Ce646f68AC8c248420045cb7b5e on Ethereum does the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 own?"},{"title":"Explore cross-chain NFT collection","prompt":"Fetch the NFT instances for token contract 0x3Eca1B216A7DF1C7689aEb259fFB83ADFB894E7f on Polygon and tell me the animation URLs and token types for each one."}],"resultDescription":"A paginated list of NFT token instances for the specified contract, each including: instance ID, owner details, value, metadata object, image URL, media URL, media type, thumbnail URLs (60x60, 250x250, 500x500, original), token type, animation URL, external app URL, image media type, animation media type, and next_page_params for pagination.","failureModes":["Invalid or non-existent chain_id returns 404 or empty response","Invalid address_hash_param format returns 422 validation error","Contract address is not an NFT contract — returns empty items array","Pagination cursor mismatch leads to duplicate or missing items","Rate limiting or payment failure returns 402 Payment Required","Non-NFT (fungible) token address returns empty or malformed response"],"whenToPreferThis":"Use this endpoint when you need to enumerate all NFT instances (ERC-721 or ERC-1155) minted under a specific contract on a supported blockchain, especially when you need rich metadata including images, animations, and ownership. Prefer this over generic blockchain explorers when you need Blockscout's cross-chain support and structured NFT-specific response format with thumbnails. Best for agents building NFT galleries, portfolio trackers, or collection analytics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T00:30:01.926Z","isFirstParty":false}