{"uid":"cap_8Ch1WPyawo7tgC9L3B3F-","slug":"blockscout-nft-token-instance-holders-a64886d5","name":"Blockscout NFT Token Instance Holders","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/holders","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"}}},"queryParams":{"type":"object","properties":{"value":{"type":"string"},"token_id":{"type":"string"},"items_count":{"type":"integer"},"address_hash":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"value":"string","address":{"hash":"string","name":"string","is_scam":true,"metadata":{},"proxy_type":"string","reputation":"string","is_contract":true,"is_verified":true,"public_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"private_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"ens_domain_name":"string","implementations":[{"name":"string","address_hash":"string"}],"watchlist_names":[{"label":"string","display_name":"string"}]},"token_id":"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_NkXEcZyT2zo7fRN6kplDA","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 the list of addresses holding a specific NFT token instance (by token ID) for a given contract on a specified blockchain network","exampleAgentPrompt":"Using Blockscout, show me all the addresses holding token ID 42 of the NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum (chain ID 1).","exampleUseCases":[{"title":"NFT Ownership Audit for a Collection","prompt":"Can you look up who holds token ID 1337 of the NFT contract 0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB on Ethereum mainnet using Blockscout?"},{"title":"Cross-chain NFT holder lookup","prompt":"On Polygon (chain ID 137), which addresses are holding token ID 5 of the contract 0x2953399124F0cBB46d2CbACD8A89cF0599974963? Pull the full list from Blockscout."},{"title":"Airdrop eligibility verification for NFT instance","prompt":"I need to verify who holds token ID 99 of the contract 0xd07dc4262BCDbf85190C01c996b4C06a461d2430 on Arbitrum so I can validate airdrop eligibility — can you get that from Blockscout?"}],"resultDescription":"A paginated list of holder records, each containing the holder's address hash, optional name, ENS domain, reputation score, proxy type, public/private tags, watchlist names, contract verification status, scam flag, and the specific token ID held. Also includes next_page_params for pagination.","failureModes":["Invalid chain_id returns 404 or error — must use a supported Blockscout chain identifier","Invalid or non-existent token contract address returns empty result or 404","Non-existent token_id_param returns empty items array","Fungible token contract address used instead of NFT contract may return unexpected results","Rate limiting or payment failure returns 402 Payment Required","Pagination cursor mismatch may return duplicate or skipped results"],"whenToPreferThis":"Use this endpoint when you need to identify all holders of a specific NFT token instance (by token ID) on a particular chain — especially when you need rich metadata per holder (ENS name, reputation, tags, proxy info). Prefer this over generic token holder endpoints when the token is an NFT (ERC-721 or ERC-1155) and you need instance-level granularity rather than balance-level data across all holders of a fungible token.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T12:30:01.614Z","isFirstParty":false}