{"uid":"cap_QI5_slT2_bv875dAfkYAk","slug":"token-holder-concentration-analysis-81a3d6c9","name":"Token Holder Concentration Analysis","description":"Ethereum ERC-20 holder concentration from Blockscout: top 100 holders' share of total supply, top 10 share, and a Gini coefficient over those 100 balances. Gini is over the top 100 only, not all holders. Ethereum mainnet only.","url":"https://api.chainmarket-api.workers.dev/api/crypto/token-holder-concentration?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":["address"],"properties":{"address":{"type":"string","description":"ERC-20 token contract on Ethereum mainnet, 0x + 40 hex characters"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"name":"Tether","source":"https://eth.blockscout.com/api/v2/tokens/0xdAC17F958D2ee523a2206206994597C13D831ec7/holders","symbol":"USDT","address":"0xdAC17F958D2ee523a2206206994597C13D831ec7","decimals":6,"checkedAt":"2026-10-23T09:36:07.913Z","topHolders":[{"address":"0xF977814e90dA44bFA03b6295A0616a897441aceC","balance":16000000001.13621,"sharePct":18.1198},{"address":"0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503","balance":9184997801.482302,"sharePct":10.4019}],"totalSupply":88301265725.97054,"holdersTotal":16915076,"top10SharePct":48.5083,"giniTopHolders":0.7672,"holdersSampled":100,"top100SharePct":66.2657}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_V-dEKdaHd1UQlTo62DNnF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves on-chain holder distribution metrics for an ERC-20 token on Ethereum mainnet, including top holder balances, share percentages, Gini coefficient, and concentration statistics.","exampleAgentPrompt":"Can you pull the holder concentration data for the USDT token at contract address 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum — I want to see the top holders, their share percentages, and the Gini coefficient to assess how centralized the supply is?","exampleUseCases":[{"title":"DeFi token whale risk assessment","prompt":"Before I invest in this new DeFi token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum, can you check how concentrated its holder base is? I want to know what percentage of supply the top 10 wallets control and whether the Gini coefficient signals manipulation risk."},{"title":"Stablecoin custody distribution audit","prompt":"Can you analyze the holder distribution for USDT at contract 0xdAC17F958D2ee523a2206206994597C13D831ec7 — specifically show me the top 100 wallets' combined share and the total number of holders so I can assess custodial concentration risk?"},{"title":"Token launch decentralization check","prompt":"We just launched our governance token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum mainnet. Can you pull the current holder concentration stats, including the top holders list and their share percentages, to confirm it's well distributed?"}],"resultDescription":"Returns a JSON object with the token's name, symbol, contract address, decimals, total supply, and total holder count. Includes a list of top holders (up to 100 sampled) with each holder's address, balance, and percentage share of supply. Also provides aggregate concentration metrics: top-10 share percentage, top-100 share percentage, and the Gini coefficient of the top holders, plus a timestamp of when the data was checked.","failureModes":["Invalid or malformed contract address (not 0x + 40 hex chars) returns a 400 error","Address is valid Ethereum format but not an ERC-20 token contract — may return empty or error response","Token exists but has no holder data indexed on Blockscout — returns partial or empty holder list","Payment fails due to unsupported network or insufficient USDC balance — call is not charged","Upstream Blockscout API unavailability causes timeout or 502 error","Token with very low holder count may produce statistically unreliable Gini coefficient"],"whenToPreferThis":"Choose this endpoint when you need on-chain, verifiable holder distribution data for an ERC-20 token on Ethereum mainnet — especially for whale concentration risk assessment, decentralization audits, or investment due diligence. It is preferable over generic portfolio or price APIs when the specific question is about ownership structure rather than price or liquidity. Best suited for DeFi research, token launch verification, or governance risk analysis where Gini coefficient and top-holder share percentages are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:45:47.297Z","isFirstParty":false,"canonicalSlug":"token-holder-concentration-analysis-81a3d6c9"}