Full holder analytics for any Base ERC-20: total holders with 24h/3d/7d/30d holder-change
Full holder analytics for any Base ERC-20: total holders with 24h/3d/7d/30d holder-change momentum, whale-tier distribution, acquisition mix (swap vs transfer vs airdrop), top-10/25/50/100 supply share, labeled top holders with concentration (top1/5/10/20% + contract-held%) and an AI concentration-risk read. Bag check, holder analytics, holder concentration, whale distribution. $0.03 per call.
30000 (raw units)
price
1
calls / 30d
1
unique payers
2026-08-30
updated
Provider
x402.ottoai.services · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "30000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"queryParams": {
"token": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed"
},
"type": "http"
},
"output": {
"example": {
"data": {
"analysisStatus": "ok",
"chain": "base",
"concentration": {
"contractHeldPct": 22.8,
"top10Pct": 27.1,
"top1Pct": 5.69,
"top20Pct": 38.55,
"top5Pct": 18.42
},
"generatedAt": "2026-06-11T12:00:00.000Z",
"holderChange": {
"24h": {
"change": -312,
"changePercent": -0.06
},
"30d": {
"change": -8204,
"changePercent": -1.53
},
"3d": {
"change": 1204,
"changePercent": 0.23
},
"7d": {
"change": 4810,
"changePercent": 0.92
}
},
"holderDistribution": {
"crabs": 98200,
"dolphins": 2150,
"fish": 11800,
"octopus": 24500,
"sharks": 310,
"shrimps": 391650,
"whales": 124
},
"holderSupply": {
"top10": {
"supply": "13497000000",
"supplyPercent": 36.5
},
"top100": {
"supply": "24530000000",
"supplyPercent": 66.4
},
"top25": {
"supply": "17890000000",
"supplyPercent": 48.4
},
"top50": {
"supply": "21260000000",
"supplyPercent": 57.5
}
},
"holdersByAcquisition": {
"airdrop": 21000,
"swap": 311200,
"transfer": 196534
},
"riskRead": "The holder base is large (529k) and stable over 24h with mild 7d growth, so distribution risk is structural rather than momentum-driven. Top-10 wallets hold 36.5% of supply, but the largest positions are DEX liquidity contracts rather than EOAs — contract-held supply (22.8%) is mostly Uniswap pools. Acquisition skews to swaps over airdrops, consistent with an organically bought base; no single EOA above 4.4% means dump risk from any one wallet is contained.",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"topHolders": [
{
"balanceFormatted": "2104566516.77",
"entity": "Uniswap",
"isContract": true,
"label": "Uniswap V3: DEGEN 3",
"ownerAddress": "0x3304e22ddaa22bcdc5fca2269b418046ae7b566a",
"pctOfSupply": 5.69,
"usdValue": 8418266.07
}
],
"totalHolders": 528734
},
"meta": {
"degraded": false,
"generatedAt": "",
"stalenessSec": 0,
"validUntil": ""
},
"status": "success"
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"token": {
"description": "Base ERC-20 token contract address (0x...). Common symbols also accepted as shorthand: weth, usdc, cbbtc, cbxrp, cbdoge, usol.",
"type": "string"
}
},
"required": [
"token"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"data": {
"description": "Endpoint payload (see meta.generatedAt for freshness)"
},
"meta": {
"type": "object"
},
"status": {
"enum": [
"success"
],
"type": "string"
}
},
"required": [
"status",
"data",
"meta"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
},
"builder-code": {
"info": {
"a": "bc_hc2dhq09"
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"a": {
"description": "App builder code",
"pattern": "^[a-z0-9_]{1,32}$",
"type": "string"
},
"s": {
"description": "Service builder codes",
"items": {
"pattern": "^[a-z0-9_]{1,32}$",
"type": "string"
},
"type": "array"
},
"w": {
"description": "Wallet builder code",
"pattern": "^[a-z0-9_]{1,32}$",
"type": "string"
}
},
"type": "object"
}
},
"offer-receipt": {
"info": {
"offers": [
{
"acceptIndex": 0,
"format": "eip712",
"payload": {
"amount": "30000",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"network": "eip155:8453",
"payTo": "0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808",
"resourceUrl": "https://x402.ottoai.services/holder-analytics",
"scheme": "exact",
"validUntil": 1788096580,
"version": 1
},
"signature": "0xba79204b50f873e76ac70347006ce15e793253bf31f09e93103fd2ea6ec70750729ec6622c283732142707979fb8a7ee330f85bb0de3ce342e9d62780862f50b1c"
}
]
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"offers": {
"items": {
"properties": {
"acceptIndex": {
"type": "integer"
},
"format": {
"type": "string"
},
"payload": {
"properties": {
"amount": {
"type": "string"
},
"asset": {
"type": "string"
},
"network": {
"type": "string"
},
"payTo": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"scheme": {
"type": "string"
},
"validUntil": {
"type": "integer"
},
"version": {
"type": "integer"
}
},
"required": [
"version",
"resourceUrl",
"scheme",
"network",
"asset",
"payTo",
"amount"
],
"type": "object"
},
"signature": {
"type": "string"
}
},
"required": [
"format",
"signature"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"offers"
],
"type": "object"
}
},
"otto-content-receipt": {}
}Use it
curl
curl "https://x402.ottoai.services/holder-analytics" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://x402.ottoai.services/holder-analytics");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://x402.ottoai.services/holder-analytics")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/206.json, and this resource appears in /discovery/resources and /discovery/search.