{"uid":"cap_CUmNLuOPogcsb4SiGUhC_","slug":"erc-20-top-holder-concentration-check-104b4372","name":"ERC-20 Top Holder Concentration Check","description":"Pre-trade exit-liquidity check for an ERC-20: top-10 holder concentration %, ex-LP/ex-known-router concentration, per-holder balance %, contract-or-EOA flag. High concentration = thin exit liquidity. Chains: ethereum, base, arbitrum, optimism.","url":"https://meryol-payai.hf.space/holders/top/:chain/:token","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","HEAD","DELETE"],"type":"string"},"pathParams":{"type":"object","required":["chain","token"],"properties":{"chain":{"enum":["ethereum","base","arbitrum","optimism"],"type":"string"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["holders","top_n_concentration_pct"]}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","pathParams":{"chain":"ethereum","token":"0x6B175474E89094C44Da98b954EedeAC495271d0F"}}},"response":{"name":"Dai","chain":"ethereum","notes":[],"token":"0x6b175474e89094c44da98b954eedeac495271d0f","top_n":10,"symbol":"DAI","holders":[{"address":"0x40ec5b33f54e0e8a33a975908c5ba1c14e5bbbdf","balance_pct":15.7501,"is_contract":true,"discount_label":"RootChainManagerProxy"},{"address":"0xf6e72db5454dd049d0788e411b06cfaf16853042","balance_pct":9.8885,"is_contract":true,"discount_label":"DssLitePsm"},{"address":"0x250ba4e73a365cefdd170a2b1ff9fc03097d64f3","balance_pct":3.6658,"is_contract":true,"discount_label":"ERC1967Proxy"},{"address":"0x4dedf26112b3ec8ec46e7e31ea5e123490b05b8b","balance_pct":2.2408,"is_contract":true,"discount_label":"InitializableImmutableAdminUpgradeabilityProxy"},{"address":"0x6ace8a8a416f7e5c75331874fcafea7d9362795d","balance_pct":0.8855,"is_contract":false,"discount_label":null},{"address":"0x837c20d568dfcd35e74e5cc0b8030f9cebe10a28","balance_pct":0.8116,"is_contract":false,"discount_label":null},{"address":"0xf84213cda40246be080bfa1744301b9e37ee4852","balance_pct":0.7566,"is_contract":false,"discount_label":null},{"address":"0x07ede94cf6316f4809f2b725f5d79ad303fb4dc8","balance_pct":0.6655,"is_contract":false,"discount_label":null},{"address":"0xae33fb0ceb844559c638b23725f009e2f182c862","balance_pct":0.6066,"is_contract":false,"discount_label":null},{"address":"0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7","balance_pct":0.5923,"is_contract":true,"discount_label":"TriPool"}],"decimals":18,"total_supply":"4228303325593980681724110475","holders_count_total":719988,"top_n_concentration_pct":35.8633,"top_n_concentration_ex_known_pct":3.7258}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xNvvmU57ILrDnfcFrShWD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns top-10 holder concentration metrics for an ERC-20 token on a given chain, enabling pre-trade exit-liquidity risk assessment.","exampleAgentPrompt":"Before I swap into this token, check the top-holder concentration for 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum — I want to know if the top 10 holders dominate the supply and whether they're contracts or regular wallets.","exampleUseCases":null,"resultDescription":"Returns the percentage of supply held by the top 10 holders (overall concentration), the concentration excluding known LPs and routers, a breakdown of each holder's balance percentage, and a contract-or-EOA flag per holder — giving a clear picture of whether exit liquidity is thin or healthy.","failureModes":["Invalid token address format (not a valid 0x hex address) returns 422 validation error","Unsupported chain name returns enum validation error","Token not found or no holder data available on the requested chain returns empty or 404 response","Rate limiting or upstream data provider outage returns 5xx error","Payment not provided or insufficient returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when an AI agent needs to assess pre-trade exit-liquidity risk for an ERC-20 token on Ethereum, Base, Arbitrum, or Optimism. It is specifically useful when the user wants to know if a token is whale-dominated, LP-excluded concentration, or largely held by contracts — before executing a swap or position. Prefer this over generic token info endpoints when holder-distribution risk is the primary concern.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:39:51.774Z","isFirstParty":false}