{"uid":"cap_gU9marDYVPBOMVeTt518R","slug":"erc-20-token-holder-distribution-228690fa","name":"ERC-20 Token Holder Distribution","description":"Largest holders of an ERC-20 token: address (named or labelled when known: exchanges, protocols...), amount and % of supply, total holder count and top-10 concentration.","url":"https://api.vextorium.com/token-holders-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"red":{"enum":["ethereum","base","arbitrum","optimism","polygon","zksync"],"type":"string"},"token":{"type":"string"},"limite":{"type":"integer"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_uVxqe-B3J_9py9YHq64-1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the largest holders of an ERC-20 token with labeled addresses, amounts, percentages of supply, total holder count, and top-10 concentration metric.","exampleAgentPrompt":"Who are the top 20 largest holders of the USDC token (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) on Ethereum — show me their addresses, any known labels like exchanges or protocols, how much they hold, and what percentage of supply that is, plus the top-10 concentration?","exampleUseCases":[{"title":"Token whale concentration check","prompt":"Can you pull the top 50 holders of this token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum and tell me how concentrated the supply is among the top 10 wallets?"},{"title":"DeFi protocol ownership audit","prompt":"I need to know who the biggest holders of ARB token are on Arbitrum — are major exchanges or protocols in that list, and what percentage of supply do the top 10 control?"},{"title":"Rug pull risk assessment","prompt":"Check the top holders for token 0x6B175474E89094C44Da98b954EedeAC495271d0F on base and flag if the supply looks dangerously concentrated — I want to see named wallets if any are known."}],"resultDescription":"Returns a JSON object containing: the token's name, symbol, total supply, total holder count, source network, top holders array (each with address, optional ENS/name label, whether it's a contract, token amount held, and percentage of total supply), and a top-10 concentration percentage (concentracion_top10_pct). Addresses are labeled when identifiable as exchanges, DeFi protocols, or known entities.","failureModes":["Invalid or non-ERC-20 contract address returns error or empty result","Unsupported network (outside ethereum/base/arbitrum/optimism/polygon/zksync) returns validation error","Token with no holders or very new token may return empty holders array","Rate limiting or payment failure returns 402 or error response","Token contract exists but has no indexable holder data on the requested chain"],"whenToPreferThis":"Use this endpoint when you need on-chain holder distribution data for ERC-20 tokens across major EVM networks (Ethereum, Base, Arbitrum, Optimism, Polygon, zkSync), especially when you need labeled addresses (exchanges, protocols) rather than raw addresses alone. Prefer this over generic blockchain explorers when you want structured, agent-ready JSON with concentration metrics included. Best for DeFi due diligence, tokenomics analysis, whale monitoring, and rug-pull risk assessment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:47:20.666Z","isFirstParty":false,"canonicalSlug":"erc-20-token-holder-distribution-228690fa"}