{"uid":"cap_pb0I5EpJ_um0p4_W-3-nU","slug":"token-top-holders-lookup-78db61c5","name":"Token Top Holders Lookup","description":"Returns top holders for any Ethereum ERC-20 token (by contract address), with concentration metrics. Includes each holder's share%, human-readable balance (with decimal conversion), and whale analysis. Reports: top-10 concentration, whale count (>1% holders), Herfindahl-Hirschman Index for concentration risk. Use to assess token distribution health, identify institutional-grade holders, or screen for rug-pull risk before entering a position.","url":"https://the-stall.intuitek.ai/cap/token-top-holders","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":10,"token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"}}},"response":{"token":{"name":"USD Coin","symbol":"USDC","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","decimals":6,"price_usd":0.999782,"total_supply":51499647284.47,"holders_count":7284708,"market_cap_usd":74886049628},"holders":[{"rank":1,"address":"0x37305b1cd40574e4c5ce33f8e8306be057fd7341","balance":4108639566.875787,"share_pct":7.98,"balance_raw":"4108639566875787"},{"rank":2,"address":"0xe1940f578743367f38d3f25c2d2d32d6636929b6","balance":1699999999.039577,"share_pct":3.3,"balance_raw":"1699999999039577"},{"rank":3,"address":"0x38aaef3782910bdd9ea3566c839788af6ff9b200","balance":1690023294.45702,"share_pct":3.28,"balance_raw":"1690023294457020"},{"rank":4,"address":"0xffa69c0080582098af595156240214b742735a5e","balance":1582999999.8601,"share_pct":3.07,"balance_raw":"1582999999860100"},{"rank":5,"address":"0xad354cfbaa4a8572dd6df021514a3931a8329ef5","balance":1400000000.5201,"share_pct":2.72,"balance_raw":"1400000000520100"},{"rank":6,"address":"0x40ec5b33f54e0e8a33a975908c5ba1c14e5bbbdf","balance":1094007916.709261,"share_pct":2.12,"balance_raw":"1094007916709261"},{"rank":7,"address":"0xee7ae85f2fe2239e27d9c1e23fffe168d63b4055","balance":853718376.502793,"share_pct":1.66,"balance_raw":"853718376502793"},{"rank":8,"address":"0x01b8697695eab322a339c4bf75740db75dc9375e","balance":769256809.436414,"share_pct":1.49,"balance_raw":"769256809436414"},{"rank":9,"address":"0x2744dfd9898f0babbc570cc594bbbc84b487a22b","balance":654436717.190902,"share_pct":1.27,"balance_raw":"654436717190902"},{"rank":10,"address":"0x3d09d2354530466d32ed37c6ad19ea58504a0c37","balance":636909737.148484,"share_pct":1.24,"balance_raw":"636909737148484"}],"timestamp":"2026-06-12T05:11:01.576Z","concentration":{"hhi":114.77,"top1_pct":7.98,"top5_pct":20.35,"top10_pct":28.13,"risk_label":"DISPERSED","whale_count":10}}},"exampleRequest":{"limit":10,"token_address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"tags":["x402"],"displayCostAmount":"0.059","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.059/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.059","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.059","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_erQ4oBXRXVQ9g0QFr7CSQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.059","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top holders of an ERC-20 token by wallet address and balance, given a contract address.","exampleAgentPrompt":"Who are the top 50 holders of the USDC token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?","exampleUseCases":null,"resultDescription":"A ranked list of up to 100 wallet addresses and their token balances for the specified ERC-20 contract, ordered by holdings descending — useful for analyzing token concentration, identifying whales, or auditing holder distribution.","failureModes":["Invalid or malformed token contract address returns an error","Contract address does not correspond to an ERC-20 token — may return empty or error","Limit exceeds 100 — clamped or rejected","Payment failure via x402/USDC causes 402 response and no data returned","Token has no indexed holders (very new or obscure contract) — empty result"],"whenToPreferThis":"Use this endpoint when you need on-chain holder distribution data for any Ethereum ERC-20 token without requiring API keys or account setup. Ideal for DeFi analytics, whale tracking, token audit, or concentration risk assessment. Prefer over alternatives when paying per-call in USDC on Base mainnet is acceptable and no long-term subscription is desired.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:56:25.243Z","isFirstParty":false}