{"uid":"cap_OMPdb1vBY8Fpc6NKbg3Y_","slug":"agent402-token-holders-lookup-d4e55878","name":"Agent402 Token Holders Lookup","description":"Top holders of any token on any Blockscout-hosted chain - address, balance, and share of supply, ranked - bought per call from Blockscout's Pro API over x402, no API key. Concentration analysis for any ERC-20/721 on dozens of chains. Mega-tokens with hundreds of thousands to millions of holders (USDC, WETH, AERO) can exceed the upstream time budget - that returns a 500 and you are not charged. Marked untrustedContent: external explorer data, analyze don't trust.","url":"https://agent402.tools/api/token-holders","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"chain name or numeric id (default base)"},"limit":{"type":"integer","description":"top holders to return, 1–50 (default 20)"},"address":{"type":"string","description":"token contract address (0x…)"}}},"responseSchema":{"type":"json","example":{"chain":"8453","address":"0x9401…8631","holders":[{"value":"…","address":"0x…"}],"holderCount":10,"untrustedContent":true}},"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_GGYPG7pFcAVgOnXHO9KRH","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 top token holders for a given ERC-20 contract address on a specified blockchain, with holder addresses and balances.","exampleAgentPrompt":"Who are the top 20 holders of the token at contract 0x9401...8631 on Base? I want to see the addresses and their balances to check for whale concentration.","exampleUseCases":[{"title":"DeFi token whale concentration check","prompt":"Pull the top 50 holders for the token at contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum so I can see if any whales are dominating the supply."},{"title":"New token launch holder audit","prompt":"I just launched a token at 0x1234abcd5678ef on Base — can you fetch the top 20 holders so I can verify the distribution looks healthy and no single wallet dominates?"},{"title":"Competitor token holder research","prompt":"Show me the top 30 wallets holding the token at contract 0xdeadbeef1234567890 on Base — I'm doing research on its holder base for a competitive analysis."}],"resultDescription":"Returns a JSON object containing the chain ID, token contract address, an array of top holder objects (each with an address and value/balance), the total holder count, and an untrustedContent flag. The holders array is sorted by balance descending, limited to the requested count (default 20, max 50).","failureModes":["Invalid or non-existent contract address returns empty holders array or error","Chain not supported or unrecognized chain name causes lookup failure","Limit out of range (>50 or <1) rejected with validation error","Payment not provided or insufficient USDC causes 402 Payment Required","Network congestion on-chain may cause delayed or stale holder data","Contract is not a standard ERC-20 may return partial or empty results"],"whenToPreferThis":"Use this endpoint when you need on-chain token holder data for EVM-compatible chains (especially Base) and want pay-per-call access with no API key or signup. Prefer this over block explorer UIs when building automated workflows that need programmatic holder lists. It supports multiple chains and returns structured JSON suitable for downstream analysis. Choose it when you need fast, affordable ($0.01/call) holder snapshots without committing to a subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:14:05.683Z","isFirstParty":false}