Back to Browse
Otto AI — ERC-20 Token Holder Analytics
x402
Otto AI — ERC-20 Token Holder Analytics is a paid API for AI agents from x402.ottoai.services, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-15).
Returns detailed holder distribution, concentration metrics, acquisition breakdown, and risk assessment for a Base ERC-20 token contract address
Price / call$0.03
Success—
StatusUnknown
How this service works
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.
Output
Returns a JSON object with: total holder count, 24h/3d/7d/30d holder change deltas, top holder list with wallet address, entity label, USD value, and % of supply, concentration metrics (top 1/5/10/20% and contract-held %), tiered holder distribution (whales, sharks, dolphins, octopus, crabs, fish, shrimps), acquisition source breakdown (swap vs airdrop vs transfer), chain identifier, and a plain-language risk narrative summarizing distribution risk and dump risk.
Example use cases
Example prompt
“Pull the holder analytics for the DEGEN token at contract address 0x4ed4e862860bed51a9570b96d89af5e1b0efefed on Base — I want to know how concentrated the supply is, who the top holders are, and whether the holder count has been growing or shrinking lately.”
Technical details
Endpoint
GEThttps://x402.ottoai.services/holder-analyticsWhen to prefer
Use this endpoint when you need deep holder-level intelligence for a specific Base ERC-20 token — especially when assessing concentration risk, tracking holder growth trends, identifying whale wallets, or distinguishing organic buy pressure from airdrop-inflated counts. Prefer this over generic block explorers when you need a structured, agent-readable breakdown with entity labels and risk narrative included.
Side effects
- Invalid or non-existent token contract address returns error or empty data
- Token not indexed on Base returns no holder data
- Stale data if generatedAt is old and validUntil has passed
- Network or upstream indexer downtime may return degraded:true in meta
- Payment failure (insufficient USDC) blocks the request entirely
Input
{
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"token": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed"
}
}
}Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
{
"data": {
"chain": "base",
"riskRead": "The holder base is experiencing a slow, consistent contraction across 24-hour, 7-day, and 30-day windows, indicating stagnant momentum and a lack of new capital inflow. While 44% of the supply is managed by contracts, the top 100 wallets control a massive 89% of tokens, with four unidentified private wallets in the top 10 alone holding nearly 20% of the total supply. Holder quality is poor; over 51% of the 1.19 million holders are airdrop recipients, and the distribution is overwhelmingly \"shrimps,\" suggesting a fragmented base of non-organic participants likely to sell into any liquidity. The high concentration of supply in a few EOA (externally owned account) wallets alongside a massive, airdrop-heavy retail tail creates a significant risk of coordinated dumps or a slow bleed as farmers exit.",
"topHolders": [
{
"label": null,
"entity": null,
"usdValue": 14321096.336962273,
"isContract": true,
"pctOfSupply": 23.360324098855006,
"ownerAddress": "0x06a19654e0872ba71c2261ea691ecf8a0c677156",
"balanceFormatted": "8598560554.475672174864104168"
},
{
"label": null,
"entity": null,
"usdValue": 3369928.167841195,
"isContract": false,
"pctOfSupply": 5.496968412079633,
"ownerAddress": "0x82d4cd9bf16017fd518511d8bbe6d0493af31a10",
"balanceFormatted": "2023345890.120737828511330738"
},
{
"label": null,
"entity": null,
"usdValue": 3178168.359269977,
"isContract": false,
"pctOfSupply": 5.18417313635787,
"ownerAddress": "0x9773c9e7d048ae91a4fd9a48cd0b984e31fa418c",
"balanceFormatted": "1908210966.989284933307315429"
},
{
"label": null,
"entity": null,
"usdValue": 3078379.960896953,
"isContract": true,
"pctOfSupply": 5.021400030692556,
"ownerAddress": "0x7d00d30269fc62ab5fab54418feedbdc71fdb25f",
"balanceFormatted": "1848296798.0"
},
{
"label": null,
"entity": null,
"usdValue": 2984654.346050103,
"isContract": true,
"pctOfSupply": 4.868516432421107,
"ownerAddress": "0x21bb2a7e0e26449e60e6fb994cd435b11bfe1a1a",
"balanceFormatted": "1792022798.034921359715880266"
},
{
"label": null,
"entity": null,
"usdValue": 2873162.204942629,
"isContract": false,
"pctOfSupply": 4.686652384483398,
"ownerAddress": "0x4cc69ff3264e61d5d5e8f368331320c66dad2714",
"balanceFormatted": "1725081559.452058179479322015"
},
{
"label": null,
"entity": null,
"usdValue": 2443749.9880533824,
"isContract": false,
"pctOfSupply": 3.9862026198483806,
"ownerAddress": "0x13454580bd3300075eb4b2470a107a5cf4e6af35",
"balanceFormatted": "1467257237.7048428659201995"
},
{
"label": null,
"entity": null,
"usdValue": 1992513.0554559708,
"isContract": true,
"pctOfSupply": 3.250152757266097,
"ownerAddress": "0x17891b029eaead89a82bde0f398f87f5def4a1dd",
"balanceFormatted": "1196329091.0"
},
{
"label": null,
"entity": null,
"usdValue": 1847016.867835995,
"isContract": true,
"pctOfSupply": 3.0128218980931045,
"ownerAddress": "0x565b551b98e7a8823b37e3f4e2d56b1906104de8",
"balanceFormatted": "1108971409.0"
},
{
"label": "Bybit: Hot Wallet",
"entity": "Bybit",
"usdValue": 1466935.6010638997,
"isContract": false,
"pctOfSupply": 2.392839924172325,
"ownerAddress": "0xbaed383ede0e5d9d72430661f3285daa77e9439f",
"balanceFormatted": "880765990.150418422393903326"
}
],
"generatedAt": "2026-06-12T04:56:40.308Z",
"holderChange": {
"3d": {
"change": -427,
"changePercent": -0.036
},
"7d": {
"change": -983,
"changePercent": -0.082
},
"24h": {
"change": -420,
"changePercent": -0.035
},
"30d": {
"change": -147,
"changePercent": -0.012
}
},
"holderSupply": {
"top10": {
"supply": "22548842294.93",
"supplyPercent": 61
},
"top25": {
"supply": "29162509934.02",
"supplyPercent": 79
},
"top50": {
"supply": "31527610088.03",
"supplyPercent": 86
},
"top100": {
"supply": "32917819616.46",
"supplyPercent": 89
}
},
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"totalHolders": 1192827,
"concentration": {
"top1Pct": 23.36,
"top5Pct": 43.93,
"top10Pct": 61.26,
"top20Pct": 75.68,
"contractHeldPct": 44.35
},
"analysisStatus": "ok",
"holderDistribution": {
"fish": 1431,
"crabs": 10322,
"sharks": 17,
"whales": 64,
"octopus": 3331,
"shrimps": 1177310,
"dolphins": 352
},
"holdersByAcquisition": {
"swap": 240943,
"airdrop": 612218,
"transfer": 339666
}
},
"meta": {
"degraded": false,
"validUntil": "2026-06-12T05:01:40.309Z",
"generatedAt": "2026-06-12T04:56:40.309Z",
"sourceHealth": {
"moralis-holders": "ok",
"moralis-holder-stats": "ok"
},
"stalenessSec": 0,
"inputSnapshotId": "holder-analytics:0x4ed4e862860bed51a9570b96d89af5e1b0efefed@v2"
},
"status": "success"
}Schema · Response
{
"type": "json",
"example": {
"data": {
"chain": "base",
"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.",
"topHolders": [
{
"label": "Uniswap V3: DEGEN 3",
"entity": "Uniswap",
"usdValue": 8418266.07,
"isContract": true,
"pctOfSupply": 5.69,
"ownerAddress": "0x3304e22ddaa22bcdc5fca2269b418046ae7b566a",
"balanceFormatted": "2104566516.77"
}
],
"generatedAt": "2026-06-11T12:00:00.000Z",
"holderChange": {
"3d": {
"change": 1204,
"changePercent": 0.23
},
"7d": {
"change": 4810,
"changePercent": 0.92
},
"24h": {
"change": -312,
"changePercent": -0.06
},
"30d": {
"change": -8204,
"changePercent": -1.53
}
},
"holderSupply": {
"top10": {
"supply": "13497000000",
"supplyPercent": 36.5
},
"top25": {
"supply": "17890000000",
"supplyPercent": 48.4
},
"top50": {
"supply": "21260000000",
"supplyPercent": 57.5
},
"top100": {
"supply": "24530000000",
"supplyPercent": 66.4
}
},
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed",
"totalHolders": 528734,
"concentration": {
"top1Pct": 5.69,
"top5Pct": 18.42,
"top10Pct": 27.1,
"top20Pct": 38.55,
"contractHeldPct": 22.8
},
"analysisStatus": "ok",
"holderDistribution": {
"fish": 11800,
"crabs": 98200,
"sharks": 310,
"whales": 124,
"octopus": 24500,
"shrimps": 391650,
"dolphins": 2150
},
"holdersByAcquisition": {
"swap": 311200,
"airdrop": 21000,
"transfer": 196534
}
},
"meta": {
"degraded": false,
"validUntil": "",
"generatedAt": "",
"stalenessSec": 0
},
"status": "success"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"