{"uid":"cap_4NgdiZA3fn_6ZfCMN2OQF","slug":"erc20-top-holders-whale-concentration-lookup-f73992f9","name":"ERC20 Top Holders & Whale Concentration Lookup","description":"Top holders of an ERC20 token with balances and percentage of supply, plus the concentration of the largest holders, by contract and chain, from an indexed source behind an API key. For risk and whale analysis. token holders, whale concentration, top holders, supply distribution, rug risk Accepts payment on Base or Solana — either network works.","url":"https://api.x402node.dev/token/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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"default ethereum"},"limit":{"type":"string","description":"top N (default 20, max 50)"},"address":{"type":"string","description":"token contract 0x..."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_k9aFlhaHNpNFcssPNujrg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top holders of an ERC20 token with their balances, percentage of supply, and whale concentration metrics for risk and rug-pull analysis, sourced from an indexed on-chain data provider.","exampleAgentPrompt":"Can you pull the top holders and whale concentration for the ERC20 token at contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum mainnet? I want to know if ownership is too concentrated before I invest.","exampleUseCases":null,"resultDescription":"A ranked list of the top ERC20 token holders with each wallet address, their balance, and their percentage of total supply, plus an aggregated whale concentration metric indicating how much of the supply is controlled by the largest holders — useful for rug risk and market manipulation analysis.","failureModes":["Invalid or non-existent contract address returns an error or empty result","Unsupported chain ID returns a 400 or 422 error","Token with no indexed Transfer history may return incomplete or stale data","Rate limiting or missing API key returns 401/402 payment required","Very new tokens with few transactions may have sparse holder data"],"whenToPreferThis":"Choose this endpoint when you need indexed, pre-aggregated top-holder data for an ERC20 token across supported chains with whale concentration metrics included — faster than reconstructing from raw Transfer events (see the Base-specific sibling endpoint for event-based estimation). Best for quick risk screening, rug analysis, or whale watching on established tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:00:16.829Z","isFirstParty":false}