{"uid":"cap_Fe_Sw9Zxrbwz_bEEUZp_8","slug":"otto-ai-token-top-holders-a40c20d5","name":"Otto AI — Token Top Holders","description":"Top holders for any Base ERC-20 (via Moralis), with computed concentration (top1/5/10/20% + contract-held%) and optional whale-risk read. Curated hot set refreshed hourly; long-tail tokens write-through on first call.","url":"https://x402.ottoai.services/token-top-holders","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","holders":[{"label":"Uniswap V3: DEGEN 3","entity":"Uniswap","usdValue":8418266.07,"isContract":true,"pctOfSupply":5.69,"ownerAddress":"0x3304e22ddaa22bcdc5fca2269b418046ae7b566a","balanceFormatted":"2104566516.77"},{"label":null,"entity":null,"usdValue":6441248.12,"isContract":false,"pctOfSupply":4.36,"ownerAddress":"0xd28cb1e0bd2f1f57c50ff85b3bcdf6cf48ddcfc9","balanceFormatted":"1610312029.43"}],"narrative":"Concentration is moderate: the top-10 wallets hold 27.1% of supply, led by a Uniswap V3 pool (5.7%). Contract-held supply (22.8%) is mostly DEX liquidity rather than team custody. No single EOA exceeds 4.4%.","generatedAt":"2026-06-09T21:00:00.000Z","totalSupply":"36965935954.18","tokenAddress":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed","concentration":{"top1Pct":5.69,"top5Pct":18.42,"top10Pct":27.1,"top20Pct":38.55,"contractHeldPct":22.8}},"meta":{"degraded":false,"validUntil":"","generatedAt":"","stalenessSec":0},"status":"success"}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"token":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed"}}},"response":{"data":{"chain":"base","holders":[{"label":null,"entity":null,"usdValue":12580471.074436482,"isContract":true,"pctOfSupply":22.858264690985173,"ownerAddress":"0x06a19654e0872ba71c2261ea691ecf8a0c677156","balanceFormatted":"8413760540.475672174864104168"},{"label":null,"entity":null,"usdValue":3025358.794297799,"isContract":false,"pctOfSupply":5.496968412079633,"ownerAddress":"0x82d4cd9bf16017fd518511d8bbe6d0493af31a10","balanceFormatted":"2023345890.120737828511330738"},{"label":null,"entity":null,"usdValue":2853206.0971602094,"isContract":false,"pctOfSupply":5.18417313635787,"ownerAddress":"0x9773c9e7d048ae91a4fd9a48cd0b984e31fa418c","balanceFormatted":"1908210966.989284933307315429"},{"label":null,"entity":null,"usdValue":2763620.891318829,"isContract":true,"pctOfSupply":5.021400030692556,"ownerAddress":"0x7d00d30269fc62ab5fab54418feedbdc71fdb25f","balanceFormatted":"1848296798.0"},{"label":null,"entity":null,"usdValue":2634049.175299437,"isContract":true,"pctOfSupply":4.785972870317395,"ownerAddress":"0x21bb2a7e0e26449e60e6fb994cd435b11bfe1a1a","balanceFormatted":"1761639836.988346017250126843"},{"label":null,"entity":null,"usdValue":2579386.2988289245,"isContract":false,"pctOfSupply":4.686652384483398,"ownerAddress":"0x4cc69ff3264e61d5d5e8f368331320c66dad2714","balanceFormatted":"1725081559.452058179479322015"},{"label":null,"entity":null,"usdValue":2193880.7443953925,"isContract":false,"pctOfSupply":3.9862026198483806,"ownerAddress":"0x13454580bd3300075eb4b2470a107a5cf4e6af35","balanceFormatted":"1467257237.7048428659201995"},{"label":null,"entity":null,"usdValue":1788782.0139912749,"isContract":true,"pctOfSupply":3.250152757266097,"ownerAddress":"0x17891b029eaead89a82bde0f398f87f5def4a1dd","balanceFormatted":"1196329091.0"},{"label":null,"entity":null,"usdValue":1658162.5619348595,"isContract":true,"pctOfSupply":3.0128218980931045,"ownerAddress":"0x565b551b98e7a8823b37e3f4e2d56b1906104de8","balanceFormatted":"1108971409.0"},{"label":"Bybit: Hot Wallet","entity":"Bybit","usdValue":1324633.3963042519,"isContract":false,"pctOfSupply":2.4068113675622067,"ownerAddress":"0xbaed383ede0e5d9d72430661f3285daa77e9439f","balanceFormatted":"885908654.332342895799949327"},{"label":null,"entity":null,"usdValue":980602.6295090253,"isContract":false,"pctOfSupply":1.7817198043990894,"ownerAddress":"0xc8802feab2fafb48b7d1ade77e197002c210f391","balanceFormatted":"655822477.6506859677"},{"label":null,"entity":null,"usdValue":974838.8758323285,"isContract":true,"pctOfSupply":1.771247270709688,"ownerAddress":"0x4e4c31e49d430a4c57c30b3ea00ab259887e915d","balanceFormatted":"651967706.0"},{"label":null,"entity":null,"usdValue":919268.3467355643,"isContract":true,"pctOfSupply":1.6702776126105516,"ownerAddress":"0xefef4558802bf373ce3307189c79a9cab0a4cb9c","balanceFormatted":"614802394.608935756371304253"},{"label":"Uniswap: V3 Pool","entity":"Uniswap","usdValue":847092.3977396705,"isContract":true,"pctOfSupply":1.5391365021776031,"ownerAddress":"0xc9034c3e7f58003e6ae0c8438e7c8f4598d5acaa","balanceFormatted":"566531455.624225358155024657"},{"label":null,"entity":null,"usdValue":845799.1173571825,"isContract":false,"pctOfSupply":1.5367866581115381,"ownerAddress":"0x4ea46c826ad7518de6eba54dac26a2e9c3eb0ffe","balanceFormatted":"565666515.719704795203613368"},{"label":null,"entity":null,"usdValue":790481.8532053004,"isContract":false,"pctOfSupply":1.4362771733328445,"ownerAddress":"0xd3e0341b361134014e0c89378b3e36bc5020cd97","balanceFormatted":"528670586.745795177507106786"},{"label":"MEXC: Hot Wallet","entity":"MEXC","usdValue":721065.8616042491,"isContract":false,"pctOfSupply":1.310150806488898,"ownerAddress":"0x4e3ae00e8323558fa5cac04b152238924aa31b60","balanceFormatted":"482245494.429681133468819599"},{"label":"Coinbase: Hot Wallet","entity":"Coinbase","usdValue":675571.1875292409,"isContract":false,"pctOfSupply":1.227488615551567,"ownerAddress":"0x40ebc1ac8d4fedd2e144b75fe9c0420be82750c6","balanceFormatted":"451818868.012494134412474254"},{"label":null,"entity":null,"usdValue":673747.0279146937,"isContract":false,"pctOfSupply":1.2241741829630566,"ownerAddress":"0xb7fa700fb515cc7f85e4684656e8e527185410ed","balanceFormatted":"450598878.546790170398764029"},{"label":"Gate.io: Hot Wallet","entity":"Gate.io","usdValue":557096.7923842401,"isContract":false,"pctOfSupply":1.0122248891533006,"ownerAddress":"0x0d0707963952f2fba59dd06f2b425ace40b492fe","balanceFormatted":"372583743.58593281396026634"}],"narrative":"Supply is highly concentrated, with the top 10 addresses controlling over 60% of the total tokens. While approximately 39% of the supply is held within smart contracts (likely vesting, staking, or liquidity), five private EOA wallets control nearly 22% of the supply, presenting significant individual dump risk. The presence of a centralized exchange hot wallet in the top 10 indicates active secondary market liquidity, but the heavy weight of unidentified private wallets remains the primary centralization concern.","generatedAt":"2026-06-18T05:53:41.500Z","totalSupply":null,"tokenAddress":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed","concentration":{"top1Pct":22.86,"top5Pct":43.35,"top10Pct":60.69,"top20Pct":75.2,"contractHeldPct":43.91}},"meta":{"degraded":false,"validUntil":"2026-06-18T05:54:41.500Z","generatedAt":"2026-06-18T05:53:41.500Z","sourceHealth":{"moralis-holders":"ok"},"stalenessSec":0,"inputSnapshotId":"token-top-holders:0x4ed4e862860bed51a9570b96d89af5e1b0efefed@v9"},"status":"success"}},"exampleRequest":{"token":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed"},"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BwmYWSXRa0GdQbQ3Dg35s","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top token holders, concentration metrics, and entity labels for a Base ERC-20 token contract address","exampleAgentPrompt":"Who are the top holders of the DEGEN token on Base (contract 0x4ed4e862860bed51a9570b96d89af5e1b0efefed)? Show me their balances, what percent of supply they hold, and whether the token is whale-concentrated.","exampleUseCases":null,"resultDescription":"Returns a ranked list of top token holders including owner addresses, USD value held, percentage of total supply, entity labels (e.g. Uniswap, Coinbase), contract vs EOA flags, and an AI-generated narrative summarizing concentration risk. Also includes aggregate stats: top-1/5/10/20 pct of supply, contract-held pct, and total supply.","failureModes":["Invalid or non-Base ERC-20 contract address returns an error","Token with no on-chain holder data may return empty holders list","Stale data if generatedAt timestamp is old and validUntil has passed","Payment failure if USDC balance is insufficient for x402 $0.02 fee","Unsupported token or chain returns no results"],"whenToPreferThis":"Use this endpoint when you need detailed holder concentration analysis for a specific Base ERC-20 token, including entity identification, whale detection, and an AI-generated summary of distribution risk. Prefer this over generic blockchain explorers when you want labeled entities, structured concentration metrics, and a narrative interpretation in a single API call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:55:54.250Z","isFirstParty":false}