# AgentOracle Token Snapshot by Symbol

> AgentOracle Token Snapshot by Symbol is a paid API for AI agents from aiagentoracle.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Looks up a single on-chain crypto token by ticker symbol and returns a full price, volume, liquidity, and market-cap snapshot.

## Facts

- Endpoint: GET https://aiagentoracle.ai/api/v1/token/:symbol
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentoracle-token-snapshot-by-symbol-26e2710a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__BB5ksaGjETk02sQ5ivxK

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 agentoracle-token-snapshot-by-symbol-26e2710a
```

Example prompt: What's the current price, 24h volume, market cap, and on-chain liquidity for SOL right now?

## When to prefer this

Choose this endpoint when you need a comprehensive single-token snapshot including price, market cap, volume, liquidity, and chain metadata in one call. Prefer this over the minimal price endpoint when you need multiple data dimensions simultaneously. Use this instead of listing endpoints when you already know the specific ticker symbol. Best suited for token research, pre-trade checks, and portfolio enrichment workflows.

## Known failure modes

- 404 Not Found if the ticker symbol is unknown or not indexed
- Symbol disambiguation issues when multiple tokens share the same ticker across chains
- Stale data if the token has not been recently updated (check lastUpdated field)
- Null fields for price, volume, liquidity, or market cap if data is unavailable for that token
- Case sensitivity issues (though the API is documented as case-insensitive)

## How this service works

AgentOracle: lookup a single on-chain crypto token by ticker symbol (case-insensitive, e.g. ETH, BTC, SOL). Returns the full price / volume / liquidity / market-cap snapshot, or 404 if the symbol is unknown.

## Output

Returns a JSON object containing the token's internal ID, ticker symbol, name, EVM chain slug, spot price in USD, fully-diluted market cap, 24h trading volume, on-chain pool liquidity, 24h price change percent, a source-quality confidence score (0–1), token image URL, and a last-updated timestamp. Returns 404 if the symbol is not found.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Uppercase ticker symbol, e.g. ETH, BTC, SOL."
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "id",
      "symbol",
      "name",
      "chain",
      "lastUpdated"
     ],
     "properties": {
      "id": {
       "type": "integer",
       "description": "Internal numeric identifier."
      },
      "name": {
       "type": "string"
      },
      "chain": {
       "type": "string",
       "description": "EVM chain slug (e.g. base, ethereum, arbitrum)."
      },
      "symbol": {
       "type": "string",
       "description": "Uppercase ticker symbol, e.g. ETH."
      },
      "imageUrl": {
       "type": [
        "string",
        "null"
       ],
       "format": "uri"
      },
      "priceUsd": {
       "type": [
        "number",
        "null"
       ],
       "description": "Spot price in USD."
      },
      "marketCap": {
       "type": [
        "number",
        "null"
       ],
       "description": "Fully-diluted market cap in USD."
      },
      "volume24h": {
       "type": [
        "number",
        "null"
       ],
       "description": "Trailing 24h trading volume in USD."
      },
      "lastUpdated": {
       "type": "string",
       "format": "date-time"
      },
      "liquidityUsd": {
       "type": [
        "number",
        "null"
       ],
       "description": "On-chain pool liquidity in USD."
      },
      "confidenceScore": {
       "type": [
        "number",
        "null"
       ],
       "description": "Source-quality score, 0..1."
      },
      "priceChange24hPercent": {
       "type": [
        "number",
        "null"
       ],
       "description": "24h price change, percent (-100..+inf)."
      }
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentoracle-token-snapshot-by-symbol-26e2710a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aiagentoracle.ai](https://www.zero.xyz/host/aiagentoracle.ai/llms.txt)