{"uid":"cap_VXGxEQvOFPsu9sr9YKY7C","slug":"evm-token-holder-concentration-analyzer-4094fe84","name":"EVM Token Holder Concentration Analyzer","description":"Holder concentration for an EVM token (Ethereum, BSC, Base, Arbitrum, Polygon): share of supply held by the top 1, top 3 and top 10 holders, total holder count, and how much of the top 10 are contracts. GoPlus gives only the top 10 holders, so the top-20 view and funding-source clustering are NOT provided.","url":"https://api.fadeandco.workers.dev/api/agent-intel/holder-cluster-analyzer?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":{"chain":{"type":"string","description":"ethereum, bsc, base, arbitrum or polygon (default ethereum)"},"address":{"type":"string","description":"Token contract address 0x... (40 hex characters)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"note":"Top 10 only (GoPlus does not return more). Funding-source clustering is not included.","chain":"ethereum","source":"https://api.gopluslabs.io/api/v1/token_security/","symbol":"PEPE","address":"0x6982508145454ce325ddbe47a25d4ec3d2311933","verdict":"DISPERSED","checkedAt":"2026-10-23T09:35:17.979Z","topHolders":[{"tag":null,"locked":false,"address":"0xf977814e90da44bfa03b6295a0616a897441acec","percent":0.08989173829407761,"isContract":false},{"tag":null,"locked":false,"address":"0x1d48963dd8fada6ab5c2c7b92eba81ecc5030270","percent":0.06166513454219776,"isContract":false}],"totalHolders":600956,"concentration":{"top1":0.0899,"top3":0.1964,"top10":0.3498},"holdersReturned":10,"contractHoldersInTop10":0}},"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_lbExCm1j7lU2jtqmrMd5L","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":"Returns holder concentration metrics (top 1/3/10 share, total holders, contract ratio) for an EVM token on Ethereum, BSC, Base, Arbitrum, or Polygon using GoPlus data.","exampleAgentPrompt":"Can you check the holder concentration for the PEPE token at 0x6982508145454ce325ddbe47a25d4ec3d2311933 on Ethereum — specifically what share the top 1, top 3, and top 10 holders control, how many total holders there are, and whether any of the top holders are contracts?","exampleUseCases":[{"title":"Rug pull risk check before investing","prompt":"Before I buy into this new Base token at 0x1234abcd... can you tell me how concentrated the holder distribution is — like what percent the top 10 wallets own and how many are contracts? I want to know if a whale could dump on me."},{"title":"Token distribution audit for listing decision","prompt":"We're evaluating whether to list a BSC token at 0xabc123... on our DEX — can you pull the holder concentration data including top 1, top 3, and top 10 holder shares and the total number of holders so we can assess distribution fairness?"},{"title":"DeFi research report on Arbitrum token","prompt":"I'm writing a research report on an Arbitrum token at 0xdef456... — give me the full holder breakdown: what percent the top holders control, total holder count, and whether any of the top 10 addresses are smart contracts."}],"resultDescription":"Returns a JSON object with: token symbol and address, chain, a concentration verdict (e.g. DISPERSED), timestamp, total holder count, number of top holders returned (up to 10), per-holder data (address, percent of supply, locked status, contract flag, tag), and summary concentration figures for top 1, top 3, and top 10 holders. Sourced from GoPlus; top-20 view and funding-source clustering are not available.","failureModes":["Invalid or non-contract token address returns an error or empty result","Unsupported chain name causes a validation error","Token with very few holders may return partial data","GoPlus upstream unavailability results in timeout or 5xx error","Token not indexed by GoPlus returns empty holder array","Missing required 'address' query parameter returns 400"],"whenToPreferThis":"Use this endpoint when you need fast, structured holder concentration data for an EVM token across Ethereum, BSC, Base, Arbitrum, or Polygon and only need the top-10 holder view. Prefer this over manually querying block explorers or GoPlus directly when you need a normalized, parsed response with concentration ratios and contract-holder flags already computed. If you need top-20+ holders or funding-source clustering, this endpoint does not support those.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:58.808Z","isFirstParty":false,"canonicalSlug":"evm-token-holder-concentration-analyzer-4094fe84"}