{"uid":"cap_Aoi67W9EKU_XdjulCkZlx","slug":"erc-20-token-holder-concentration-lookup-77b96362","name":"ERC-20 Token Holder Concentration Lookup","description":"Top holders of an ERC-20 token with labels, balances and share of supply plus top 1, 5, 10 and 20 concentration and a concentration level from Blockscout","url":"https://saylorinnovations.com/api/evm/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","required":["token"],"properties":{"top":{"type":"string","description":"optional 1-50, default 10"},"chain":{"type":"string","description":"ethereum (default), base, optimism, arbitrum, polygon, gnosis"},"token":{"type":"string","description":"Token contract 0x address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["chain","token","top_holders"],"properties":{"note":{"type":"string","description":"Caveat or context for reading the result"},"chain":{"type":"string","description":"Blockchain the data is for"},"token":{"type":"object","description":"Token the values refer to"},"source":{"type":"string","description":"Data source the values come from"},"top_holders":{"type":"array","description":"Top holders"},"concentration":{"type":"object","description":"Share of supply held by the top 1, 5, 10 and 20 holders, in percent"},"holders_returned":{"type":"number","description":"Holders returned"},"concentration_level":{"type":"string","description":"Concentration level"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_CzlO9olivyr7_pYK_lXuT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns top ERC-20 token holders with labels, balances, supply share, concentration metrics (top 1/5/10/20), and a concentration level rating from Blockscout data.","exampleAgentPrompt":"Can you pull the top 20 holders of the USDC token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum and tell me what the concentration level looks like — are whales dominating?","exampleUseCases":[{"title":"Pre-investment whale risk check","prompt":"Before I buy into this token, can you look up the top 10 holders of 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum and tell me what share of supply the top 5 control? I want to know if it's whale-heavy."},{"title":"DeFi protocol governance audit","prompt":"Can you check the token holder concentration for the Uniswap governance token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum — specifically how much supply the top 20 wallets hold and what the concentration level is?"},{"title":"New token launch decentralization check","prompt":"I'm reviewing a new token on Base at address 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed — can you get me the top 5 holders, their share of supply, and tell me whether the concentration level looks healthy or concerning?"}],"resultDescription":"A JSON object containing: the queried chain and token metadata, an array of top holders with wallet addresses, labels (e.g. exchange names), balances, and percent of supply; concentration percentages for the top 1, 5, 10, and 20 holders; a categorical concentration level (e.g. high/medium/low); the number of holders returned; and an optional note providing context.","failureModes":["Invalid or non-contract token address returns an error or empty result","Unsupported chain name causes a 400 or unrecognized parameter response","Token with very few holders may return fewer results than requested","Blockscout data unavailability for a given chain may produce stale or missing data","Top parameter outside 1-50 range may be rejected or clamped to default"],"whenToPreferThis":"Choose this endpoint when you need on-chain ERC-20 holder concentration data including labeled wallet identities, supply share breakdowns, and a pre-computed concentration level across major EVM chains (Ethereum, Base, Optimism, Arbitrum, Polygon, Gnosis). Prefer it over raw blockchain RPC calls when you need enriched labels and aggregated concentration metrics in a single call without writing custom Blockscout queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:56:43.798Z","isFirstParty":false,"canonicalSlug":"erc-20-token-holder-concentration-lookup-77b96362"}