{"uid":"cap_X06KGlfvS5IBmQqjUsFYy","slug":"arkham-token-holders-1b879829","name":"Arkham Token Holders","description":"Get Arkham top token holders by pricing ID or chain/address. $6.00 per call.","url":"https://api.arkm.com/x402/token/holders","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}}],"description":"The CoinGecko pricing ID of the token."},"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":"USDC","price":0.999831,"symbol":"usdc","identifier":{"pricingID":"usd-coin"},"price24hAgo":0.999825},"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_vX1c8tez2j_UK0FZ-CFDu","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 holders (by address and entity) for a given token, including USD balances, percentage of market cap, and Arkham entity labels.","exampleAgentPrompt":"Using Arkham's intelligence data, show me the top holders of USDC on Ethereum — I want to see the wallet addresses, their USD balances, what percentage of supply they hold, and which entities like exchanges or protocols Arkham has attributed them to.","exampleUseCases":[{"title":"Whale concentration research for a token","prompt":"Who are the top holders of USDC on Ethereum right now? Give me their wallet addresses, USD balances, share of supply, and any entity labels Arkham has for them — I'm trying to understand how concentrated the supply is."},{"title":"Exchange custody exposure analysis","prompt":"Which centralized exchanges hold the most USDC on Ethereum according to Arkham's data? I want to see their addresses, balances in USD, and what fraction of total supply they control."},{"title":"DeFi protocol collateral tracking","prompt":"Show me the top Ethereum addresses holding USDC that are attributed to DeFi protocols in Arkham — I want their balances and percent of market cap so I can track how much stablecoin collateral is locked in DeFi."}],"resultDescription":"Returns a JSON object containing: token metadata (name, symbol, current price, 24h-ago price), total supply broken down by chain, top holders by address (with USD balance, percentage of market cap, Arkham wallet label, and full Arkham entity metadata including entity type, Twitter, website), and top holders by entity. Each address entry includes whether it is a contract or EOA.","failureModes":["Invalid or unknown token symbol/identifier returns empty or error response","Unsupported chain returns no holder data for that chain","Payment failure via x402 results in 402 Payment Required with no data returned","Rate limiting or quota exhaustion may result in 429 errors","Token with no on-chain holder data returns empty holder arrays"],"whenToPreferThis":"Choose this endpoint when you need on-chain token holder distribution data enriched with Arkham's proprietary entity attribution — particularly when you want to know not just which addresses hold a token, but which real-world entities (exchanges, protocols, funds) those addresses belong to. Prefer this over generic blockchain explorers when entity labeling and USD-denominated balances are important for the analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:53:24.795Z","isFirstParty":false}