{"uid":"cap_m9TK1A_CwUVNprEJIY4-t","slug":"agenticfi-token-holders-lookup-ddf735b2","name":"AgenticFi Token Holders Lookup","description":"ERC-20 token holders by chain - ranked by balance descending with first-acquired and transfer-initiation flags","url":"https://defi-api.agenticfi.wtf/api/token/holders/%7BchainId%7D/%7Baddress%7D","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","pathParams","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["chainId","address"],"properties":{"address":{"type":"string","title":"address (required)","description":"Required. ERC-20 token contract address.\nExample: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913"},"chainId":{"type":"string","title":"chainId (required)","description":"Required EVM chain ID, e.g. '8453' for Base Examples: 8453, 1, 42161"}}},"queryParams":{"type":"object","required":["chainId","address"],"properties":{"limit":{"type":"string","title":"limit (optional)","description":"Optional. Maximum number of holders to return, 1-500 Examples: 100, 500"},"offset":{"type":"string","title":"offset (optional)","description":"Optional. Pagination cursor returned in next_offset Examples: eyJvZmZzZXQiOjEwMH0= (use next_offset from the previous response)"},"address":{"type":"string","title":"address (required)","description":"Required. ERC-20 token contract address.\nExample: 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913"},"chainId":{"type":"string","title":"chainId (required)","description":"Required EVM chain ID, e.g. '8453' for Base Examples: 8453, 1, 42161"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","pathParams":{"address":"0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","chainId":"8453"},"queryParams":{"limit":"10","address":"0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","chainId":"8453"}}},"response":{"source":"sim","holders":[{"balance":"181229042485780","first_acquired":"2025-08-05T06:40:21+00:00","wallet_address":"0xee7ae85f2fe2239e27d9c1e23fffe168d63b4055","has_initiated_transfer":false},{"balance":"160861060526471","first_acquired":"2024-05-21T17:55:09+00:00","wallet_address":"0xbbbbbbbbbb9cc5e90e3b3af64bdaf62c37eeffcb","has_initiated_transfer":false},{"balance":"160000000151753","first_acquired":"2025-12-12T19:10:47+00:00","wallet_address":"0x8da91a6298ea5d1a8bc985e99798fd0a0f05701a","has_initiated_transfer":false},{"balance":"158707811660177","first_acquired":"2025-11-04T21:25:11+00:00","wallet_address":"0xb026ba5501c9fcdb5b4b746c37e349cd61b81b22","has_initiated_transfer":false},{"balance":"86991146922079","first_acquired":"2025-12-12T17:12:27+00:00","wallet_address":"0x0ccc149f4c01a2eada3e9f915ca7628920901623","has_initiated_transfer":false},{"balance":"80000000072000","first_acquired":"2025-12-15T22:20:41+00:00","wallet_address":"0x02c79843b9548fc0cb4b35bf6840538a73fc3422","has_initiated_transfer":false},{"balance":"80000000072000","first_acquired":"2025-12-16T01:15:35+00:00","wallet_address":"0x0bdca6aa876d9e5c5c6c27c0ecfa9a78ca6ca0a3","has_initiated_transfer":false},{"balance":"80000000072000","first_acquired":"2025-12-15T19:09:01+00:00","wallet_address":"0x255fbf4351683902ccb4d32f76987b886cc927bd","has_initiated_transfer":false},{"balance":"80000000072000","first_acquired":"2025-12-15T16:38:17+00:00","wallet_address":"0x273c766d992a335b5a7c56ba41acf9ad85434877","has_initiated_transfer":false},{"balance":"80000000072000","first_acquired":"2025-12-12T21:14:07+00:00","wallet_address":"0x2c0ecf1935b150d1cc63ced67aca7113322f2f9a","has_initiated_transfer":false}],"chain_id":8453,"next_offset":"IAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEjCc5YZQBQAAAAAAAAALVRHH5wtgsfHZ6zC7ui4Lw0uJGc","token_address":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"}},"exampleRequest":{"limit":"10","address":"0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913","chainId":"8453"},"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n6kpAlatJXhMIvZB6Ifdg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated list of ERC-20 token holders with balances and acquisition dates for a given token contract on any EVM chain","exampleAgentPrompt":"Show me the top 100 holders of the USDC token contract 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913 on Base (chain ID 8453) — I want each wallet address, their balance, and when they first acquired the token.","exampleUseCases":null,"resultDescription":"Returns a paginated array of token holders, each with wallet address, raw token balance, ISO 8601 first-acquired timestamp, and a boolean indicating whether they've ever initiated a transfer. Also includes the token address, chain ID, data source, and a next_offset cursor for fetching subsequent pages.","failureModes":["Invalid or non-checksummed contract address returns an error or empty holder list","Unsupported chain ID results in an error response","Offset cursor from a different query or malformed base64 causes a pagination error","Limit value outside 1-500 range returns a validation error","Token contract with no on-chain holder data returns an empty holders array","Network congestion or upstream indexer lag may cause stale or delayed data"],"whenToPreferThis":"Use this endpoint when you need on-chain holder distribution data for an ERC-20 token on any EVM chain, especially when you want to identify top wallets by balance, analyze holder concentration, or check acquisition history. Prefer this over generic blockchain explorers when you need structured, paginated, machine-readable holder data accessible via pay-per-call without API key setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:58:41.372Z","isFirstParty":false}