{"uid":"cap_NmPMIlQKGNaH7m85O_Rt3","slug":"otto-ai-erc-20-token-holder-analytics-ac9277ed","name":"Otto AI — ERC-20 Token Holder Analytics","description":"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.","url":"https://x402.ottoai.services/holder-analytics","method":"GET","headers":{},"bodySchema":{"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"}}}}}}},"responseSchema":{"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"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"token":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed"}}},"response":{"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"}},"exampleRequest":{"token":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed"},"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EfiBlU4bBVcmsAvfn_Uo9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns detailed holder distribution, concentration metrics, acquisition breakdown, and risk assessment for a Base ERC-20 token contract address","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:32:23.169Z","isFirstParty":false}