Otto AI · Token Score

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/token-score", {
  method: "GET",
});
const data = await res.json();

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

{
  "data": {
    "band": "high",
    "caveats": [
      {
        "affects": [
          "score"
        ],
        "code": "token_score_is_market_structure_...",
        "plain": "This score measures market struc..."
      }
    ],
    "context": {
      "absPriceChange24hPct": 6.8,
      "distinctDexCount": 10,
      "fdvUsd": 418200000,
      "holderChange7dPercent": 1.9,
      "liquidityUsd": 1115151.5,
      "marketCapUsd": 414220000,
      "matchedPoolCount": 20,
      "oldestPoolAgeDays": 118,
      "pooledLiquidityUsd": 2343405.11,
      "poolsReturned": 20,
      "priceChange24hPct": -6.8,
      "priceUsd": 0.04182,
      "top10SupplyPercent": 33.4,
      "totalHolders": 3420,
      "turnover24h": 0.121,
      "volume24hUsd": 284110.9
    },
    "coverage": {
      "factorsPresent": 7,
      "factorsTotal": 7,
      "minWeightCoverage": 0.5,
      "planesAnswered": [
        "dex-price-base"
      ],
      "planesUnavailable": [],
      "weightCoverage": 1
    },
    "factors": [
      {
        "absenceReason": null,
        "input": 2343405.11,
        "inputUnit": "USD",
        "key": "liquidity",
        "measures": "USD liquidity summed across the ...",
        "plane": "dex-pools-token",
        "planeReadAt": "2026-09-01T11:58:06.000Z",
        "present": true,
        "score": 85.6,
        "weight": 0.24
      }
    ],
    "formula": {
      "bands": [
        {
          "band": "very-high",
          "min": 80
        }
      ],
      "description": "Each factor maps its raw input o...",
      "factors": [
        {
          "breakpoints": [
            {
              "score": 0,
              "x": 0
            }
          ],
          "inputField": "context.pooledLiquidityUsd",
          "inputUnit": "USD",
          "key": "liquidity",
          "measures": "USD liquidity summed across the ...",
          "plane": "dex-pools-token",
          "weight": 0.24
        }
      ],
      "method": "weighted-mean-of-piecewise-linea...",
      "minWeightCoverage": 0.5
    },
    "generatedAt": "2026-09-01T12:00:00.000Z",
    "methodology": "https://docs.useotto.xyz/acp-swa...",
    "note": "A single 0-100 read on this toke...",
    "score": 74.6,
    "scoreWithheldReason": null,
    "token": {
      "address": "0x532f27101965dd16442e59d40670fa...",
      "name": "Brett",
      "network": "base",
      "symbol": "BRETT"
    }
  },
  "meta": {
    "degraded": false,
    "generatedAt": "",
    "stalenessSec": 0,
    "validUntil": ""
  },
  "status": "success"
}