Otto AI · Holder Analytics

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://x402.ottoai.services/holder-analytics", {
  method: "GET",
});
const data = await res.json();

curl -X GET \
  "https://x402.ottoai.services/holder-analytics?token=0x4ed4e862860bed51a9570b96d89af5e1b0efefed" \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "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"
}