{"uid":"cap_guSPx6VwFUSEiD-RcXfk7","slug":"verifylite-erc-20-token-holder-distribution-94028c41","name":"VerifyLite ERC-20 Token Holder Distribution","description":"The largest holders of an ERC-20 token on Base, ranked, with balance, percent of supply and wallet/contract/burn type, read straight from the chain. Top 1/5/10 concentration (burns excluded), a wallets-only share, burned percent and a low-to-very-high level. For tokens whose whole transfer history fits (most new and small tokens) the list and holder count are exact; otherwise coverage is reported. Not charged for invalid input.","url":"https://verifylite.hydratinghealingtouch.workers.dev/chain/holders?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","description":"How many holders to list, 1 to 50 (default 10)."},"token":{"type":"string","description":"Token contract 0x address on Base."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0051","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.0051/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0051","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0051","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U9yXkvqk_DKWqrV8KpSUC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0051","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 ERC-20 token on Base, ranked by balance, with concentration metrics, wallet type classification, burned token percentage, and supply distribution analysis.","exampleAgentPrompt":"Can you pull the top 10 holders of the token at 0x4200000000000000000000000000000000000006 on Base and tell me how concentrated the supply is — including what percent has been burned and whether the concentration level is high?","exampleUseCases":[{"title":"Whale concentration check before investment","prompt":"Before I buy into this token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base, show me the top 10 holders, what share of supply they control, and whether the concentration is dangerously high."},{"title":"Rug-pull risk screening for new token","prompt":"I just found a new token on Base at 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — can you get me the top 20 holders, the burned percentage, and tell me if a small group of wallets controls most of the supply?"},{"title":"Token distribution audit for project transparency","prompt":"I need to audit our project token at 0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb on Base — get me the top 5 holders with their balances and percent of supply, broken down by wallet type so I can see how much is in contracts versus regular wallets."}],"resultDescription":"Returns a ranked list of top ERC-20 token holders on Base with each holder's balance, percentage of total supply, and wallet/contract/burn classification. Also returns aggregate metrics: top-1, top-5, and top-10 supply concentration (excluding burn addresses), a wallets-only share percentage, the percentage of supply that has been burned, an overall concentration level label (low to very-high), and where applicable the total holder count and coverage status for tokens with large transfer histories.","failureModes":["Invalid or non-existent token contract address returns no charge and an error response","Token contract exists but is not ERC-20 compliant — may return partial or empty data","Tokens with very large transfer histories may return approximate holder counts with coverage percentage rather than exact figures","Limit parameter outside 1–50 range may be rejected or clamped","Network issues with Base RPC nodes may cause timeouts"],"whenToPreferThis":"Choose this endpoint when you need on-chain holder distribution data for an ERC-20 token on Base, especially for concentration risk assessment, whale analysis, burn rate evaluation, or token transparency audits. It is superior to general block explorers when you need structured, pre-computed concentration metrics (top-1/5/10 share, wallets-only share, burned percent, concentration level) in a single API call without scraping. Best for DeFi due-diligence workflows, token safety screening, and portfolio risk monitoring on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-13T12:42:35.816Z","isFirstParty":false,"canonicalSlug":"verifylite-erc-20-token-holder-distribution-94028c41"}