{"uid":"cap_g7uIHb9EQzf4ovWgNif9r","slug":"arkham-token-holders-by-id-89cb985a","name":"Arkham Token Holders by ID","description":"Get Arkham top token holders by pricing ID. $6.00 per call.","url":"https://api.arkm.com/x402/token/holders/by-id","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."},"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)."},"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_YbjzA51LA1vz_UNk1GzIw","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 specific token, including balances, USD values, percentage of market cap, and Arkham intelligence labels.","exampleAgentPrompt":"Using Arkham's intelligence data, show me the top wallet holders of USDC (pricing ID: usd-coin) on Ethereum — I want to see their balances, USD values, percentage of supply, and which entities like exchanges or protocols own them.","exampleUseCases":[{"title":"Whale tracking for a stablecoin","prompt":"Who are the biggest holders of USDC on Ethereum right now? I want to see the top wallet addresses, how much they hold, and which entities like Binance or MakerDAO own them according to Arkham."},{"title":"DeFi protocol concentration risk","prompt":"I need to analyze holder concentration for a specific token — can you pull the top holders for the token with pricing ID 'usd-coin' and tell me what percentage of the total supply the top 10 addresses control?"},{"title":"Institutional ownership intelligence","prompt":"Which institutional entities — like CEXes, DAOs, or lending protocols — are the largest holders of USDC? Use Arkham's token holder data and show me their entity type, balance, and USD value."}],"resultDescription":"A JSON object containing: token metadata (name, symbol, current price, 24h ago price), total supply per chain, top holders broken down by entity and by address. Each address entry includes the wallet address, chain, balance, USD value, percentage of market cap, Arkham label (human-readable name), and Arkham entity details (entity ID, name, type such as CEX/CDP, website, Twitter, LinkedIn, Crunchbase).","failureModes":["Invalid or unknown token pricing ID returns empty or error response","Unsupported chain in query returns no holder data","Malformed POST body causes 400 Bad Request","Insufficient x402 payment or expired payment token causes 402 Payment Required","Rate limiting or quota exceeded returns 429 Too Many Requests","Token with no tracked holders returns empty addressTopHolders and entityTopHolders arrays"],"whenToPreferThis":"Use this endpoint when you need Arkham's proprietary entity-labeled on-chain holder data for a specific token — particularly when you want to distinguish between anonymous wallets and known entities (exchanges, DAOs, protocols). Prefer this over generic on-chain RPC queries when you need human-readable labels, USD valuations, and institutional attribution. Best for whale tracking, concentration analysis, and institutional ownership research.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:51:48.325Z","isFirstParty":false}