Token holder concentration snapshot for an ERC-20 on the Base network
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.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://api.jagent.dev/v1/token-holders
| Category | Market data |
|---|---|
| Provider host | api.jagent.dev |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 1 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-03 | valid payment request | 402 | $0.008 | 460 ms |
Example input (from the provider)
{
"body": {
"address": "0x1111111111111111111111111111111111111111",
"blocks": 500
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$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"
}