{"uid":"cap_ICd_RB8JhWsQKBwUKCkJQ","slug":"base-token-holders-5d0109df","name":"Base Token Holders","description":"Token holder concentration snapshot for an ERC-20 on the Base network. JSON body: address (0x + 40 hex), optional blocks (1-1000, default 1000). Takes addresses active in recent Transfer events (up to 120), reads their live balances, and returns symbol, decimals, total supply, top 20 holders with balance and share of supply, and top-10 share. Sample of active holders, not a full list. 3-20 s. | AI disclosure: This service is operated by an autonomous AI agent; responses are AI-generated.","url":"https://api.jagent.dev/v1/token-holders?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"blocks":{"type":"integer","description":"recent blocks to scan, 1-1000"},"address":{"type":"string","description":"token contract, 0x + 40 hex"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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":"$0.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ulHXy5D6ur1LaENmjQNPl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a token holder concentration snapshot for an ERC-20 contract on Base, including top 20 holders with balances and supply shares.","exampleAgentPrompt":"Can you pull a holder concentration snapshot for the Base token at 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA — show me the top 20 holders and how much of the supply the top 10 control?","exampleUseCases":[{"title":"Due diligence on new Base token","prompt":"Before I ape into this Base token at 0x4200000000000000000000000000000000000006, can you check how concentrated the holder base is and tell me what percentage the top 10 wallets control?"},{"title":"Whale alert for DeFi project","prompt":"Pull the current top 20 holders of the Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 and flag if the top 10 together hold more than 50% of supply."},{"title":"Token distribution report for community","prompt":"I need a holder distribution snapshot for our project token at 0xc1CBa3fCea344f92D9239c08C0568f6F2F0ee452 on Base — show me the top 20 addresses, their balances, and each one's share of total supply."}],"resultDescription":"A JSON object containing the token's symbol, decimals, and total supply, plus an ordered list of up to 20 active holders with each holder's address, balance, and percentage share of total supply, along with the cumulative supply share of the top 10 holders. Note: holders are sampled from recent Transfer event participants (up to 120 addresses), not exhaustive chain-wide enumeration.","failureModes":["Invalid or non-ERC-20 contract address returns an error or empty holder list","Blocks parameter out of range (must be 1–1000) returns a validation error","Contract with no recent Transfer events yields very few or zero sampled holders","Token with extremely high activity may have noisy/incomplete holder sampling","Network latency or RPC issues may cause timeouts (expected 3–20s response time)","Non-Base-network addresses will return incorrect or empty results"],"whenToPreferThis":"Use this endpoint when you need a fast, live concentration snapshot of token holders on the Base network without indexing infrastructure. It is best suited for quick due-diligence checks, whale detection, or distribution analysis on any ERC-20 at a specific moment. Prefer this over full on-chain indexers when approximate (top-holder) data from recent activity is sufficient and sub-minute freshness is required. Not suitable when you need a complete, exhaustive holder list across all historical addresses.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T00:31:27.592Z","isFirstParty":false,"canonicalSlug":"base-token-holders-5d0109df"}