{"uid":"cap_5KUx9IcQnoeXTpkHfYUVb","slug":"agenticfi-erc-20-token-holders-by-chain-177fce01","name":"AgenticFi ERC-20 Token Holders by Chain","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/8453/:address","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":null,"exampleRequest":null,"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_CA964vxTs4GpmlGl0p5Dc","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 ERC-20 token holders on a specified EVM chain ranked by balance descending, with first-acquired and transfer-initiation flags","exampleAgentPrompt":"Show me the top 100 holders of the token at address 0x833589fCD6EDB6E08f4c7C32D4f71b54bdA02913 on Base (chain 8453), ranked by balance, including which wallets were first acquirers or initiated transfers.","exampleUseCases":[{"title":"Analyze token concentration risk","prompt":"Get the top 50 holders of USDC on Ethereum and tell me what percentage of the total supply is held by the top 10 wallets. Flag any whales that were early adopters."},{"title":"Find early token community members","prompt":"Show me all the early acquirers of the token at 0x6B175474E89094C44Da98b954EedeAC495271d0F on mainnet, sorted by balance, so I can understand who the original community was."},{"title":"Track active token movers","prompt":"List the largest holders of this token on Arbitrum (chain 42161) and highlight which ones have initiated transfers, so I can identify the most active traders."}],"resultDescription":"A paginated list of wallet addresses holding the specified ERC-20 token on the given chain, sorted by balance descending. Each entry includes the holder's balance, their rank, a flag indicating if they were among the first to acquire the token, and a flag indicating if they initiated transfers. Also includes a next_offset cursor for pagination.","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty result","Unsupported chain ID returns an error","Limit out of range (not 1-500) causes a validation error","Invalid pagination cursor causes an error","Token with no holders returns empty list","Payment failure (x402) blocks the request if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to identify top token holders on a specific EVM chain, analyze token concentration, find whale wallets, or detect early adopters and transfer initiators for a given ERC-20. Prefer this over generic blockchain explorers when you need structured, ranked, paginated holder data with behavioral flags (first-acquired, transfer-initiator) ready for agent consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:06:05.512Z","isFirstParty":false}