{"uid":"cap_BdAhaOYk_h705sOK7BejE","slug":"token-top-holders-958bbd07","name":"token-top-holders","description":"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. Default chain Base; prefix another: ethereum:, arbitrum:, optimism:, polygon:, bsc:. $0.03 per call.","url":"https://chain.intel.rallylive.ca/token/holders?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_3siGqcmJYSv367c3BgyCI","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 an ERC-20 token with supply share, balances, labels (contract/exchange), burned share, and concentration metrics across Base, Ethereum, Arbitrum, Optimism, Polygon, and BSC.","exampleAgentPrompt":"Who are the top 50 holders of the token at 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base? I want to see their supply share, any exchange or contract labels, and the concentration breakdown for the top 1, 5, 10, and 20 wallets.","exampleUseCases":[{"title":"Pre-investment whale concentration check","prompt":"Before I buy into this token, can you pull the top 50 holders for 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base and tell me how much of the supply the top 10 wallets control, and whether any are labeled as insiders or team wallets?"},{"title":"Cross-chain holder distribution comparison","prompt":"Compare the holder concentration of the same token on Ethereum (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) versus Arbitrum — show me the top 50 holders on each chain and the top 1/5/10/20 concentration metrics."},{"title":"Detecting rug-risk before a launch","prompt":"I'm looking at a new token on Polygon at 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 — can you check the top 50 holders and flag if a small number of wallets hold an outsized share of the supply, and whether any are marked as contract or exchange addresses?"}],"resultDescription":"Returns a ranked list of the top 50 holder addresses for the token, each with their balance, share of total supply, and a contract/exchange label if applicable. Also includes the percentage of supply held by burned addresses, plus aggregated concentration metrics showing what fraction of supply the top 1, 5, 10, and 20 holders collectively own.","failureModes":["Invalid or non-existent contract address returns an error or empty holder list","Unsupported chain prefix causes a bad request or no data response","Very new tokens with few on-chain transactions may have incomplete holder data","Rate limits or payment failures (x402) may block the call","Tokens on chains not supported by the endpoint return an error"],"whenToPreferThis":"Use this endpoint when you need to assess token holder concentration, whale risk, or insider control across EVM-compatible chains — especially Base, Ethereum, Arbitrum, Optimism, Polygon, or BSC. Prefer this over generic block explorers when you need structured, labeled, and pre-aggregated concentration metrics (top 1/5/10/20) in a single call rather than manually paginating holder lists. Best suited for pre-investment due diligence, DeFi risk screening, or automated token safety checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:42:38.203Z","isFirstParty":false,"canonicalSlug":"token-top-holders-958bbd07"}