{"uid":"cap_6VydEI9Tvk_7ARs0wmsqH","slug":"chainray-nft-holders-lookup-d13db37f","name":"ChainRay NFT Holders Lookup","description":"ChainRay /nft-holders","url":"https://chainray.online/nft-holders/:var1","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"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["contract"],"properties":{"chain":{"type":"string","description":"Blockchain network"},"contract":{"type":"string","description":"NFT contract address"}}}},"additionalProperties":false}}},"responseSchema":null,"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_Uw8P1EQH_Ab9VS6QKNT-z","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":"Returns the list of holders for a given NFT contract address on a specified blockchain network","exampleAgentPrompt":"Can you pull up all the current holders of the NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum using ChainRay?","exampleUseCases":null,"resultDescription":"A list of wallet addresses that currently hold tokens from the specified NFT contract, along with relevant ownership data such as token counts or IDs per holder, for the requested blockchain network.","failureModes":["Invalid or non-existent contract address returns an error or empty result","Unsupported blockchain network in the 'chain' parameter returns an error","Missing required 'contract' query parameter returns a 400-level error","Contract address is not an NFT contract returns an error or empty result","Network timeout or chain RPC unavailability causes a service error"],"whenToPreferThis":"Use this endpoint when you need to enumerate the current holders of a specific NFT collection by contract address on any supported blockchain. Ideal for snapshot analysis, airdrop targeting, holder distribution analytics, or verifying token ownership at scale. Prefer this over general token APIs when you specifically need NFT holder enumeration across multiple chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:49:23.603Z","isFirstParty":false}