{"uid":"cap_MDSPAhFYwaxSlgRHy_ISH","slug":"erc20-holder-distribution-on-base-8b6c4dde","name":"ERC20 Holder Distribution on Base","description":"Top token holders and whale concentration for an ERC20 on Base, estimated from recent Transfer events, with each holder's percentage. token holders, holder distribution, whale concentration, top holders, token ownership, holder analysis Accepts payment on Base or Solana — either network works.","url":"https://api.x402node.dev/chain/holder-distribution","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":{"top":{"type":"string","description":"Number of top holders to return, default 10, max 50"},"chain":{"type":"string","description":"base (default, only chain with enhanced rpc)"},"token":{"type":"string","description":"ERC20 contract address (optional)"},"address":{"type":"string","description":"ERC20 contract address (required)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"response":{"note":"Estimated from recent token transfers (sampled), not full historical state.","_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","chain":"base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","topHolders":[{"address":"0x3fe04a59ebd38cf06080a6f60a98d124eb59392a","balance":448870.2797,"pctOfTracked":43.77},{"address":"0xecec48ec5a7b7f7b96460b0f4e2b99cf0db94cb1","balance":138985.7571,"pctOfTracked":13.55},{"address":"0xb2cc224c1c9fee385f8ad6a55b4d94e92359dc59","balance":79123.7502,"pctOfTracked":7.72},{"address":"0xd981d5f386c9ea7a716112e6e2c84daaffa52885","balance":78795.3531,"pctOfTracked":7.68},{"address":"0xd86cadb414171d1155aa88076504763f7de32805","balance":36031.73,"pctOfTracked":3.51},{"address":"0xff3db913467576bff1fd2d4b79d4b3aa980aeccd","balance":27103.0955,"pctOfTracked":2.64},{"address":"0x2f59e9086ec8130e21bd052065a9e6b2497bb102","balance":19337.5118,"pctOfTracked":1.89},{"address":"0xbeeb9eee061925cc6d2122f05a4e6536f0feb000","balance":16814.7262,"pctOfTracked":1.64},{"address":"0x4cd00e387622c35bddb9b4c962c136462338bc31","balance":14534.3848,"pctOfTracked":1.42},{"address":"0xec6c44e704eb1932ec5fe1e4aba58db6fee71460","balance":12685.7452,"pctOfTracked":1.24}],"concentration":{"top10PctOfTracked":85.06},"trackedHolders":611,"sampledTransfers":5000}},"exampleRequest":{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_7DGRzd64D3NCL0ZXn1gMi","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 and whale concentration for an ERC20 token on Base, estimated from recent Transfer events with each holder's percentage share.","exampleAgentPrompt":"Can you check the top token holders and whale concentration for the ERC20 token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to see each holder's percentage and how concentrated the ownership is.","exampleUseCases":null,"resultDescription":"A list of top ERC20 token holders on Base with each holder's wallet address and their percentage of total supply, along with a whale concentration metric derived from recent Transfer events.","failureModes":["Invalid or non-existent contract address returns an error","Contract address is not an ERC20 on Base network","Insufficient recent Transfer events to estimate holder distribution accurately","Rate limiting or payment failure returns 402 status","Token with very low activity may yield incomplete or stale holder data"],"whenToPreferThis":"Use this endpoint when you need to quickly assess token ownership concentration, identify whale wallets, or evaluate holder distribution health for an ERC20 token specifically on the Base network. It is ideal for token due diligence, rug-pull risk screening, or DeFi research workflows where understanding who holds large portions of a token matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:59:13.102Z","isFirstParty":false}