# Otto AI Token Price Lookup

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

Returns real-time USD price, market cap, 24h volume, liquidity, and price change for any crypto token by ticker symbol or contract address

## Facts

- Endpoint: GET https://x402.ottoai.services/token-price
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/otto-ai-token-price-lookup-a4205a7e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__5BFwCzp7cpY-nEBYCqKU

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-price-lookup-a4205a7e
```

Example prompt: What's the current USD price, market cap, and 24h volume for ETH right now?

## When to prefer this

Use this endpoint when you need real-time USD token prices, market cap, 24h volume, and liquidity for any major or long-tail crypto token — especially when you need to resolve by ticker symbol OR by contract address across multiple chains including Base, Ethereum, Solana, Polygon, BSC, Arbitrum, Optimism, and Avalanche. Prefer this over generic CoinGecko or CoinMarketCap wrappers when you need on-chain pool data and liquidity context alongside the price.

## Known failure modes

- Unknown or unsupported ticker symbol returns an error or empty data
- Contract address on unsupported network may fail resolution
- Stale or degraded data flagged in meta.degraded field
- Long-tail tokens with no GeckoTerminal coverage may return incomplete data
- Malformed network:address format causes lookup failure

## How this service works

Live DEX token price in USD by ticker symbol or contract address across Base, Ethereum, Solana, Polygon, BSC, Arbitrum, Optimism and Avalanche (bare 0x tries Base then all chains, else network:address). Symbols resolve to the canonical top-market-cap asset — squat-proof. Flat JSON: price, 24h change, volume, market cap, FDV, liquidity — echoes the matched deployment. Token price, crypto price, DEX price. $0.001 per call.

## Output

A JSON object with token name, symbol, address, network, current USD price, fully diluted valuation, market cap, 24h volume, liquidity, 24h price change percentage, top liquidity pool info, data source (GeckoTerminal), and freshness timestamp. Includes a meta field indicating degraded status and staleness in seconds.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "token": "ETH"
  }
 }
}
```

## 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": [
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "description": "Ticker symbol (e.g. ETH — resolves to the canonical top-market-cap asset; use address mode for long-tail), contract address (0x… tries Base, then any supported chain), or network:address (e.g. solana:JUPyiwr…). Networks: base, ethereum, solana, polygon, bsc, arbitrum, optimism, avalanche"
      }
     }
    }
   },
   "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": {
   "mode": "symbol",
   "name": "Wrapped Ether",
   "fdvUsd": 195203400000,
   "lookup": "eth",
   "symbol": "WETH",
   "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
   "network": "ethereum",
   "topPool": {
    "dex": null,
    "name": "WETH / USDT 0.05%",
    "address": "0x11b815efb8f581194ae79006d24e0d814b7697f6"
   },
   "priceUsd": 1621.02,
   "generatedAt": "2026-06-10T12:00:00.000Z",
   "sourcedFrom": "geckoterminal",
   "liquidityUsd": 88210445.1,
   "marketCapUsd": 195203400000,
   "volume24hUsd": 184205500.4,
   "priceChange24hPct": -3.05
  },
  "meta": {
   "degraded": false,
   "validUntil": "",
   "generatedAt": "",
   "stalenessSec": 0
  },
  "status": "success"
 }
}
```

## More

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