# Otto AI — ERC-20 Token Holder Analytics > 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 ## Facts - Endpoint: GET https://x402.ottoai.services/holder-analytics - Price: $0.03/call - Payment: x402 - Status: unknown - Last checked: 2026-09-15 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/otto-ai-erc-20-token-holder-analytics-ac9277ed - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NmPMIlQKGNaH7m85O_Rt3 Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability otto-ai-erc-20-token-holder-analytics-ac9277ed ``` 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. ## When to prefer this 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. ## Known failure modes - 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 ## 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 request ```json { "input": { "type": "http", "method": "GET", "queryParams": { "token": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed" } } } ``` ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET" ], "type": "string" }, "queryParams": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "description": "Base ERC-20 token contract address (0x...). Common symbols also accepted as shorthand: weth, usdc, cbbtc, cbxrp, cbdoge, usol." } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object", "required": [ "status" ], "properties": { "data": {}, "meta": { "type": "object" }, "reason": { "type": "string", "description": "status=unavailable only; every >=400 is UNCHARGED" }, "status": { "enum": [ "success", "unavailable" ], "type": "string" } } } } } } } ``` ## Response schema (JSON Schema) ```json { "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" } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/otto-ai-erc-20-token-holder-analytics-ac9277ed/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from x402.ottoai.services](https://www.zero.xyz/host/x402.ottoai.services/llms.txt)