{"slug":"api-jagent-dev-v1-token-holders-ca481f","title":"Token holder concentration snapshot for an ERC-20 on the Base network","host":"api.jagent.dev","method":"POST","resource":"https://api.jagent.dev/v1/token-holders","category":"market","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 ba","price_listed":0.008,"price_asked":0.008,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":460,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"address":"0x1111111111111111111111111111111111111111","blocks":500},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"address":{"description":"token contract, 0x + 40 hex","type":"string"},"blocks":{"description":"recent blocks to scan, 1-1000","type":"integer"}},"required":["address"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"address":{"type":"string"},"block":{"type":"number"},"blocks_scanned":{"type":"number"},"candidates_checked":{"type":"number"},"chain":{"type":"string"},"decimals":{"type":"number"},"holders_with_balance":{"type":"number"},"note":{"type":"string"},"symbol":{"type":"string"},"top10_share_pct":{"type":"number"},"top_holders":{"type":"array"},"total_supply":{"type":"string"},"transfers_seen":{"type":"number"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-03","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.008,"price_match":true,"latency_ms":460,"error":null}],"description_full":"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.","last_updated":"2026-10-03T12:16:25.046Z","schemes":["exact"]}