{"uid":"cap_C2Y7pPbH0a3Cw2aGOJHgk","slug":"chainray-token-holders-552fc02e","name":"ChainRay Token Holders","description":"ChainRay /token-holders","url":"https://chainray.online/token-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":["address"],"properties":{"chain":{"type":"string","description":"Blockchain network"},"address":{"type":"string","description":"Wallet or contract address"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Ki4fQvNZOI5ba4l92aNRW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","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 token holders for a given token contract address on a specified blockchain network","exampleAgentPrompt":"Can you pull the token holders list for the contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?","exampleUseCases":[{"title":"Whale concentration analysis for a DeFi token","prompt":"Show me all the token holders for contract 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 on Ethereum — I want to see how concentrated the holdings are among the top wallets."},{"title":"Airdrop eligibility snapshot","prompt":"I need to get the full list of holders for token address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on the Ethereum chain so I can figure out who qualifies for our airdrop."},{"title":"Monitoring token distribution on a new chain","prompt":"Can you look up who holds the token at address 0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c on BSC? I'm trying to understand the holder distribution before making an investment decision."}],"resultDescription":"A list of wallet addresses holding the specified token, along with their respective balances or share of total supply, providing a snapshot of the token's holder distribution on the requested blockchain network.","failureModes":["Invalid or malformed contract address returns an error response","Unsupported blockchain network for the 'chain' parameter returns an error","Contract address is not a token contract (e.g. an EOA or non-token contract) may return empty results or error","Network congestion or RPC issues may cause slow or failed responses","Rate limiting or payment failure (x402) if balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need on-chain holder data for a specific token contract — especially useful for DeFi research, airdrop planning, whale tracking, or governance analysis. Prefer this over general blockchain explorers when you need structured, machine-readable holder data accessible programmatically by an AI agent across 46+ chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:58:56.402Z","isFirstParty":false}