# Otto AI Token Fundamentals

> Otto AI Token Fundamentals is a paid API for AI agents from x402.ottoai.services, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns comprehensive token fundamental data including price, market cap, supply, ROI, ATH/ATL, and sentiment for any major cryptocurrency by ticker symbol.

## Facts

- Endpoint: GET https://x402.ottoai.services/token-fundamentals
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/otto-ai-token-fundamentals-1af20574
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YjPQdDJ2l2BIO4YYX_9xr

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-token-fundamentals-1af20574
```

Example prompt: What are the fundamentals for BTC right now — price, market cap, circulating supply, all-time high, and how it's performed over the last year?

## When to prefer this

Choose this endpoint when you need a comprehensive snapshot of a token's fundamentals in a single call — price, supply, ROI across multiple timeframes, ATH/ATL, and sentiment — rather than piecing together data from multiple sources. Ideal for research, portfolio analysis, or when an agent needs rich token context before making a trading or DeFi decision. Costs only $0.002 USDC per call via x402.

## Known failure modes

- Symbol not found or ambiguous — resolves to highest market cap asset with exact symbol match, so niche tokens may not return expected results
- Stale data — meta.stalenessSec indicates how old the data is
- Network or payment failure — x402 USDC payment must succeed before data is returned
- Symbol case sensitivity issues — use uppercase ticker symbols like BTC, ETH, SOL

## How this service works

Structured token fundamentals by ticker symbol (resolves to the top-market-cap asset matching it): price, market cap, FDV, rank, 24h volume, full supply breakdown (circulating/total/max), ATH + drawdown from ATH, ATL + recovery, ROI windows (24h/7d/30d/60d/1y), categories, and project links — clean JSON an agent can consume field-by-field. Fundamentals snapshot, not a streaming price feed.

## Output

A JSON object with comprehensive token data: current price in USD, market cap, 24h trading volume, supply metrics (circulating, total, max), ROI across multiple timeframes (24h, 7d, 30d, 60d, 1y), all-time high and low with drawdown/upside percentages, community sentiment, token categories, genesis date, CoinGecko ID, and social/explorer links. Also includes a meta block with freshness/staleness information.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "symbol": "BTC"
  }
 }
}
```

## 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": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Token ticker symbol (e.g. BTC, ETH, SOL, LINK) — resolved to the HIGHEST-market-cap asset with an exact symbol match"
      }
     }
    }
   },
   "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": {
   "ath": {
    "date": "2026-01-18T04:00:00.000Z",
    "priceUsd": 126350,
    "drawdownPct": -17.5
   },
   "atl": {
    "date": "2013-07-06T00:00:00.000Z",
    "priceUsd": 67.81,
    "upsidePct": 153642.2
   },
   "roi": {
    "pct1y": 48.7,
    "pct7d": -2.4,
    "pct24h": 1.85,
    "pct30d": 6.1,
    "pct60d": 11.2
   },
   "name": "Bitcoin",
   "rank": 1,
   "links": {
    "twitter": "https://x.com/bitcoin",
    "explorer": "https://mempool.space/",
    "homepage": "http://www.bitcoin.org"
   },
   "supply": {
    "max": 21000000,
    "total": 19920000,
    "circulating": 19920000,
    "circulatingPctOfMax": 94.9
   },
   "symbol": "BTC",
   "priceUsd": 104250,
   "categories": [
    "Cryptocurrency",
    "Layer 1 (L1)",
    "Proof of Work (PoW)"
   ],
   "coingeckoId": "bitcoin",
   "generatedAt": "2026-06-10T09:00:00.000Z",
   "genesisDate": "2009-01-03",
   "marketCapUsd": 2076500000000,
   "volume24hUsd": 38420500000,
   "sentimentVotesUpPct": 84.5,
   "fullyDilutedValuationUsd": 2189250000000
  },
  "meta": {
   "degraded": false,
   "validUntil": "",
   "generatedAt": "",
   "stalenessSec": 0
  },
  "status": "success"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/otto-ai-token-fundamentals-1af20574/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)