{"uid":"cap_1SNsgkLax_JZPZx9ZfzYQ","slug":"onchainexpat-x402-token-holders-api-1323c8d8","name":"OnchainExpat x402 Token Holders API","description":"Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol","url":"https://x402.onchainexpat.com/api/x402-crypto/token-holders","method":"POST","headers":{},"bodySchema":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"Blockchain (default: ethereum)"},"address":{"type":"string","description":"Token contract address (0x + 40 hex chars)"}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"chain":{"type":"string"},"address":{"type":"string"},"token_info":{"type":"object","description":"Token name, symbol, total supply"},"top_holders":{"type":"array","description":"Top holders with address, balance, percentage, and label"},"concentration":{"type":"object","description":"Whale concentration metrics (top 10, 50, 100)"},"centralization_risk":{"type":"string","description":"Risk level: low, medium, high, extreme"}}},"success":{"type":"boolean"}}},"example":{"request":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"response":{"data":{"chain":"ethereum","token":{"name":"USD Coin","symbol":"USDC","address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","decimals":6,"holder_count":7641376,"total_supply":0,"total_supply_formatted":0},"source":"goplus","chain_name":"Ethereum","top_holders":[{"rank":1,"type":"wallet","label":null,"address":"0x37305b1cd40574e4c5ce33f8e8306be057fd7341","balance":4211025092.693546,"is_locked":false,"percentage":8.1169,"balance_raw":"4211025092.693546"},{"rank":2,"type":"contract","label":null,"address":"0x38aaef3782910bdd9ea3566c839788af6ff9b200","balance":2112218119.14602,"is_locked":false,"percentage":4.0714,"balance_raw":"2112218119.14602"},{"rank":3,"type":"contract","label":null,"address":"0xe1940f578743367f38d3f25c2d2d32d6636929b6","balance":1699999999.039577,"is_locked":false,"percentage":3.2768,"balance_raw":"1699999999.039577"},{"rank":4,"type":"contract","label":null,"address":"0xffa69c0080582098af595156240214b742735a5e","balance":1582999999.8601,"is_locked":false,"percentage":3.0513,"balance_raw":"1582999999.8601"},{"rank":5,"type":"contract","label":null,"address":"0xad354cfbaa4a8572dd6df021514a3931a8329ef5","balance":1400000000.5201,"is_locked":false,"percentage":2.6986,"balance_raw":"1400000000.5201"},{"rank":6,"type":"bridge","label":"Polygon Bridge","address":"0x40ec5b33f54e0e8a33a975908c5ba1c14e5bbbdf","balance":1173158242.504518,"is_locked":false,"percentage":2.2613,"balance_raw":"1173158242.504518"},{"rank":7,"type":"wallet","label":null,"address":"0x01b8697695eab322a339c4bf75740db75dc9375e","balance":769256809.436414,"is_locked":false,"percentage":1.4828,"balance_raw":"769256809.436414"},{"rank":8,"type":"contract","label":null,"address":"0xee7ae85f2fe2239e27d9c1e23fffe168d63b4055","balance":681398664.319736,"is_locked":false,"percentage":1.3134,"balance_raw":"681398664.319736"},{"rank":9,"type":"wallet","label":null,"address":"0x3d09d2354530466d32ed37c6ad19ea58504a0c37","balance":596909737.236433,"is_locked":false,"percentage":1.1506,"balance_raw":"596909737.236433"},{"rank":10,"type":"contract","label":null,"address":"0x08f619716db7c6245401b543e59acac1d25cb483","balance":592315216.086638,"is_locked":false,"percentage":1.1417,"balance_raw":"592315216.086638"}],"distribution":{"bridge_percent":2.26,"burned_percent":0,"contract_percent":15.55,"exchange_percent":0},"holder_count":7641376,"concentration":{"risk_level":"low","description":"Good distribution - top 10 hold under 40%","top_10_percent":28.56,"top_20_percent":28.56,"top_50_percent":28.56},"whale_wallets":[{"rank":1,"type":"wallet","label":null,"address":"0x37305b1cd40574e4c5ce33f8e8306be057fd7341","balance":4211025092.693546,"is_locked":false,"percentage":8.1169,"balance_raw":"4211025092.693546"},{"rank":7,"type":"wallet","label":null,"address":"0x01b8697695eab322a339c4bf75740db75dc9375e","balance":769256809.436414,"is_locked":false,"percentage":1.4828,"balance_raw":"769256809.436414"},{"rank":9,"type":"wallet","label":null,"address":"0x3d09d2354530466d32ed37c6ad19ea58504a0c37","balance":596909737.236433,"is_locked":false,"percentage":1.1506,"balance_raw":"596909737.236433"}]},"cached":false,"success":true,"timestamp":"2026-06-21T05:14:28.876834+00:00"}},"exampleRequest":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lPTaEFUbLT2QCADMhTZIO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of token holders for a given cryptocurrency token using the x402 pay-per-request protocol","exampleAgentPrompt":"Can you pull the list of token holders for the ERC-20 contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum so I can see how the supply is distributed?","exampleUseCases":null,"resultDescription":"A JSON object containing token holder data including wallet addresses, balances, and distribution metrics for the queried token contract","failureModes":["Invalid or unrecognized contract address returns an error or empty result","Unsupported blockchain network not indexed by the provider","Payment not processed correctly via x402 protocol resulting in 402 response","Rate limiting or quota exceeded","Token contract exists but has no indexed holder data yet"],"whenToPreferThis":"Use this endpoint when you need on-chain token holder data for a specific token contract and want pay-per-use pricing via the x402 protocol without a subscription. Prefer this over traditional blockchain data APIs when operating in an agent context that supports x402 micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:34:11.153Z","isFirstParty":false}