{"uid":"cap_e0goX3CYYqd6gNv-crMYg","slug":"blockrun-ai-token-holders-ea295122","name":"BlockRun.AI Token Holders","description":"Pay for the outcome. One endpoint for every model, tool and data source an agent needs — each call priced before it runs, at the best value per dollar. 103 models and 100 data and tool APIs.","url":"https://blockrun.ai/api/v1/surf/token/holders","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"Required query param"},"address":{"type":"string","description":"Required query param"}}},"responseSchema":null,"example":{"request":{"chain":"ethereum","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"response":{"data":[{"address":"0x37305b1cd40574e4c5ce33f8e8306be057fd7341","balance":"4107480654.105989","percentage":7.672681088629944,"entity_name":"Sky (MakerDAO)","entity_type":"cdp"},{"address":"0xe1940f578743367f38d3f25c2d2d32d6636929b6","balance":"1699999999.039577","percentage":3.1755616013098114,"entity_name":"Binance","entity_type":"cex"},{"address":"0x38aaef3782910bdd9ea3566c839788af6ff9b200","balance":"1690023294.45702","percentage":3.15692534248753},{"address":"0xffa69c0080582098af595156240214b742735a5e","balance":"1582999999.8601","percentage":2.9570082454524407},{"address":"0xad354cfbaa4a8572dd6df021514a3931a8329ef5","balance":"1400000000.5201","percentage":2.6151683799982437,"entity_name":"Binance","entity_type":"cex"},{"address":"0x40ec5b33f54e0e8a33a975908c5ba1c14e5bbbdf","balance":"1094007916.709261","percentage":2.043582078702103,"entity_name":"Polygon","entity_type":"smart-contract-platform"},{"address":"0xee7ae85f2fe2239e27d9c1e23fffe168d63b4055","balance":"857779749.316344","percentage":1.602313197558257,"entity_name":"Binance","entity_type":"cex"},{"address":"0x01b8697695eab322a339c4bf75740db75dc9375e","balance":"769256809.436414","percentage":1.4369543452779174,"entity_name":"Kraken Deposit","entity_type":"cex_deposit"},{"address":"0x2744dfd9898f0babbc570cc594bbbc84b487a22b","balance":"658632350.893536","percentage":1.230310355329142},{"address":"0x3d09d2354530466d32ed37c6ad19ea58504a0c37","balance":"636909737.148484","percentage":1.1897330034892342},{"address":"0x08f619716db7c6245401b543e59acac1d25cb483","balance":"592315216.086638","percentage":1.1064314453758197},{"address":"0x3b4d794a66304f130a4db8f2551b0070dfcf5ca7","balance":"494427348.446022","percentage":0.923579119558612,"entity_name":"Lighter","entity_type":"dex"},{"address":"0x36db199f0a1cd131ad0b5cf4fe94286faab9fda5","balance":"441256409.435511","percentage":0.824257006427579},{"address":"0xa5e4939f7cdd01a22d34dc9a29e45e9925b6cd62","balance":"400033979.654044","percentage":0.7472544386624781,"entity_name":"Kraken Deposit","entity_type":"cex_deposit"},{"address":"0x5f20b82bfa794c9cba8a15a49a02f6879e6af77c","balance":"367680069.956017","percentage":0.6868180661052169},{"address":"0xf53e4fd94365f7f8fc14087f984ff19b819fd99a","balance":"348000000.3332","percentage":0.6500561405519061},{"address":"0xe0356742a0441e64e5247dd4f4d56f9e4549e764","balance":"348000000.3332","percentage":0.6500561405519061},{"address":"0xcd180af7cd1fd3a2e88e524c29a9ece0e2bf53a6","balance":"348000000.3332","percentage":0.6500561405519061},{"address":"0x6abc301915d33ce024a27d357d0b7679c9ae74c0","balance":"348000000.3332","percentage":0.6500561405519061},{"address":"0x54999886b6153975d839220df767475d59d7c907","balance":"348000000.3332","percentage":0.6500561405519061}],"meta":{"limit":20,"cached":false,"offset":0,"credits_used":1},"$schema":"https://api.asksurf.ai/schemas/DataResponseTokenHolderItem.json"}},"exampleRequest":{"chain":"ethereum","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"},"tags":["x402"],"displayCostAmount":"0.0075","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.0075/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9vMn4dzlko9VZOq6UPWsB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","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 with their balances for a specified token contract on a given blockchain.","exampleAgentPrompt":"Who are the top token holders for contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — show me the biggest wallet balances?","exampleUseCases":null,"resultDescription":"A ranked list of the top token holders for the specified contract, including wallet addresses and their corresponding token balances, ordered by holding size.","failureModes":["Invalid or unsupported chain identifier returns an error","Invalid or non-existent token contract address returns empty or error response","Token with no holders or very new token may return empty results","Rate limiting or payment failure returns 402 or 429 status"],"whenToPreferThis":"Use this endpoint when you need to identify the largest holders (whales) of a specific on-chain token by contract address and chain, particularly for EVM-compatible chains. Prefer this over general blockchain explorers when you need structured, ranked holder data via API.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:53:53.069Z","isFirstParty":false}