{"uid":"cap_PTNim63pVAAJqKSSqiPmC","slug":"token-top-holders-ethereum-759864fc","name":"token-top-holders-ethereum","description":"Ethereum: Top 50 holders of a token with share of supply, balances, contract/exchange labels, burned share and concentration (top 1/5/10/20). Spot whale-controlled and insider-heavy tokens. $0.03 per call.","url":"https://chain.intel.rallylive.ca/token/holders/ethereum?utm_source=zero.xyz","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","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DWUnXjhTo61G_qSEiUnKK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top 50 holders of any Ethereum ERC-20 token with supply share, balances, contract/exchange labels, burned share, and concentration metrics.","exampleAgentPrompt":"Who are the top 50 holders of the PEPE token on Ethereum — show me what percentage of supply the top 10 wallets control, and flag any exchange or contract addresses in the list.","exampleUseCases":[{"title":"Whale concentration check before investing","prompt":"Before I buy into this Ethereum token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984, can you show me the top 50 holders and tell me what share of supply the top 10 wallets control? I want to know if whales could dump on me."},{"title":"Insider token detection for rug-pull screening","prompt":"Check the top holders of this new Ethereum token at 0xdAC17F958D2ee523a2206206994597C13D831ec7 — are most of the supply held by a handful of insider wallets? Flag any contracts or known exchange addresses too."},{"title":"Token holder concentration report for research","prompt":"I'm writing a report on token decentralization — pull the top 50 holders of 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum and give me the concentration breakdown for the top 1, 5, 10, and 20 holders, plus the burned share."}],"resultDescription":"Returns a ranked list of the top 50 holder addresses for the specified Ethereum ERC-20 token, each with their balance and percentage share of total supply. Also includes labels identifying contract or exchange addresses, the share of supply that has been burned, and concentration metrics showing what percentage of supply is held by the top 1, 5, 10, and 20 holders.","failureModes":["Invalid or non-existent contract address returns an error or empty result","Non-ERC-20 contract address (e.g. NFT or EOA) may return unexpected data","Token with very low on-chain activity may have incomplete holder data","Network timeouts or upstream RPC issues may cause intermittent failures","Rate limiting if called in rapid succession"],"whenToPreferThis":"Use this endpoint when you need Ethereum-specific token holder concentration data, whale detection, insider analysis, or exchange/contract label identification for ERC-20 tokens. Prefer this over generic blockchain explorers when you need structured, pre-aggregated concentration metrics (top 1/5/10/20) and labeled holder types in a single call. For other chains, use the sibling endpoints (Optimism, BSC, Polygon).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:42:04.978Z","isFirstParty":false,"canonicalSlug":"token-top-holders-ethereum-759864fc"}