{"uid":"cap_CCnY_ujaXxHXtsr3MxDsJ","slug":"arkham-token-holders-by-address-09dff8d2","name":"Arkham Token Holders by Address","description":"Get Arkham top token holders by chain/address. $6.00 per call.","url":"https://api.arkm.com/x402/token/holders/by-address","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Blockchain network where the token is deployed."},"limit":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Maximum number of holders to return per page (default 100, max 100). offset + limit must not exceed 1000."},"offset":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Number of holders to skip for pagination (default 0)."},"address":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The token contract address to query."},"poolAddress":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"Optional Solana pool address. When provided, address holder unrealized PnL is calculated from this pool only."},"groupByEntity":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"If 'true', groups holdings by entity rather than individual addresses."}}},"responseSchema":{"type":"json","example":{"token":{"name":"USD Coin","symbol":"USDC","identifier":{"chain":"ethereum","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","pricingID":"usd-coin"}},"totalSupply":{"ethereum":50539998661.70982},"entityTopHolders":{},"addressTopHolders":{"ethereum":[{"usd":4453872464.461215,"address":{"chain":"ethereum","address":"0x37305B1cD40574E4C5Ce33f8e8306Be057fD7341","contract":false,"arkhamLabel":{"name":"LITE PSM USDC A POCKET","address":"0x37305B1cD40574E4C5Ce33f8e8306Be057fD7341","chainType":"evm"},"arkhamEntity":{"id":"makerdao","name":"Sky (MakerDAO)","note":"","type":"cdp","service":null,"twitter":"https://twitter.com/MakerDAO","website":"https://makerdao.com","linkedin":"https://www.linkedin.com/company/makerdao/","crunchbase":"https://www.crunchbase.com/organization/makerdao"},"isUserAddress":false},"balance":4453872464.461215,"pctOfCap":0.06071662849686393},{"usd":1699999999.039577,"address":{"chain":"ethereum","address":"0xe1940f578743367F38D3f25c2D2d32D6636929B6","contract":true,"arkhamLabel":{"name":"SingleOwnerMSCA (Proxy)","address":"0xe1940f578743367F38D3f25c2D2d32D6636929B6","chainType":"evm"},"arkhamEntity":{"id":"binance","name":"Binance","note":"","type":"cex","service":null,"twitter":"https://twitter.com/binance","website":"https://binance.com","linkedin":"https://www.linkedin.com/company/binance","crunchbase":"https://www.crunchbase.com/organization/binance"},"isUserAddress":false},"balance":1699999999.039577,"pctOfCap":0.02317494926268423}]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"6","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":"$6/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_vIwKwIzlNs2556BGGVwDO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top token holders for a given token address on a specific chain, including entity labels, USD balances, and percentage of total supply held.","exampleAgentPrompt":"Who are the top holders of USDC on Ethereum? I want to see which wallets and entities hold the most, including their USD balances and what percentage of supply they control — use the Arkham token holders API with the USDC contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.","exampleUseCases":[{"title":"Whale concentration analysis for a DeFi token","prompt":"Show me the top 10 holders of the ARB token on Arbitrum — I want to know which wallets and named entities hold the most, their USD balances, and what share of total supply each controls."},{"title":"Exchange custody verification for a stablecoin","prompt":"Which centralized exchanges are among the largest holders of USDT on Ethereum right now? Pull the top holder list for the USDT contract and flag any addresses labeled as CEXes."},{"title":"Token distribution risk assessment","prompt":"I'm evaluating a new token at contract address 0xabc123 on Ethereum — can you pull the top holder breakdown from Arkham to see if ownership is dangerously concentrated among a few wallets?"}],"resultDescription":"A JSON object containing token metadata (name, symbol, chain, contract address, pricing ID), total supply per chain, and ranked lists of top holder addresses with USD balance, percentage of market cap, contract status, Arkham wallet labels (name, chain type), and Arkham entity information (entity ID, name, type such as CEX or CDP, social/website links).","failureModes":["Invalid or unrecognized token contract address returns empty or error response","Unsupported chain identifier causes request failure","Insufficient USDC balance for the $6 x402 pay-per-request charge results in payment failure","Token with no indexed holders returns empty holder arrays","Rate limiting or API key issues may block access","Newly deployed token contracts may have no holder data indexed yet"],"whenToPreferThis":"Use this endpoint when you need labeled, entity-enriched holder data for a specific token contract — especially when you want Arkham's proprietary entity tagging (identifying CEXes, protocols, DAOs, etc.) rather than raw on-chain data. Prefer this over generic blockchain explorers when institutional attribution and USD-denominated balances are important. Best for token concentration analysis, whale watching, and due diligence on token distribution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:44:39.972Z","isFirstParty":false}