{"uid":"cap_DmxxwiznvXkCU6us0KJNa","slug":"heurist-mesh-erc20-top-token-holders-5db4bac5","name":"Heurist Mesh: ERC20 Top Token Holders","description":"Get top 50 token holders data including wallet addresses, balances, percentages, and basic token information. Use this tool to understand token holder distribution.","url":"https://mesh.heurist.xyz/x402/solana/agents/EtherscanAgent/get_erc20_top_holders","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["chain","address"],"properties":{"chain":{"enum":["ethereum","base","arbitrum","zksync","avalanche","bsc"],"type":"string","description":"Blockchain network where the token is deployed"},"debug":{"type":"boolean","default":false,"description":"Debug mode flag. ALWAYS use false."},"address":{"type":"string","description":"Token contract address"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"result":{"type":"object","additionalProperties":true}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_FmfE4LfS69j4-a12KdsJZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top 50 token holders for a given ERC20/Solana token, including wallet addresses, balances, percentages held, and basic token metadata.","exampleAgentPrompt":"Show me the top 50 holders of the USDC token contract — I want to see how concentrated the ownership is and which wallets hold the largest percentages of supply.","exampleUseCases":[{"title":"Token whale concentration check","prompt":"Can you pull the top 50 holders for the $BONK token and tell me what percentage of supply the top 10 wallets control? I want to know if it's heavily concentrated."},{"title":"DeFi project due diligence","prompt":"I'm researching a new DeFi token before investing — can you get the top holder distribution for contract address 0xabc123 so I can see if any single wallet holds more than 5% of the supply?"},{"title":"Tracking insider wallet activity","prompt":"Look up the top 50 holders of this governance token and flag any wallets that hold more than 1% of the total supply — I want to identify potential insider or team wallets."}],"resultDescription":"Returns a list of up to 50 token holder records, each containing the wallet address, token balance held, percentage of total supply, and holder rank. Also includes basic token metadata such as name, symbol, and total supply.","failureModes":["Invalid or unrecognized token contract address returns an error or empty results","Token not indexed by Etherscan/underlying data source returns no holder data","Network mismatch (e.g. passing an Ethereum address for a Solana token) may yield incorrect results","Rate limiting or upstream data provider unavailability returns a timeout or 402 payment error","Very new tokens with minimal on-chain history may have incomplete holder data"],"whenToPreferThis":"Use this endpoint when you need structured, ranked holder distribution data for a specific token — particularly when assessing whale concentration, insider holdings, or ownership decentralization. Prefer this over general blockchain explorers when you need the data in a machine-readable format ready for agent analysis. Best suited for ERC20 tokens indexed by Etherscan or Solana tokens supported by Heurist Mesh.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:49:50.005Z","isFirstParty":false}