# x402 Agent Tools – Crypto Price Lookup

> x402 Agent Tools – Crypto Price Lookup is a paid API for AI agents from x402-agent-tools.vercel.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-01).

Fetches real-time USD price, 24h volume, market cap, and price change for up to 25 cryptocurrencies by symbol or CoinGecko ID, billed per-call via x402 micropayment.

## Facts

- Endpoint: GET https://x402-agent-tools.vercel.app/v1/crypto/price?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-agent-tools-crypto-price-lookup-15057f5e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vgTUlokCNkhJae1hEhXKT

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 x402-agent-tools-crypto-price-lookup-15057f5e
```

Example prompt: What are the current USD prices, 24h change, and market caps for bitcoin, ethereum, and solana?

## When to prefer this

Choose this endpoint when an AI agent needs real-time cryptocurrency price data without API keys or account registration, paid frictionlessly per-call via x402 micropayment in USDC. Ideal for agents that only occasionally need price data (avoiding subscription overhead), or for multi-coin batch lookups (up to 25 coins in one call). Prefer this over free-tier CoinGecko direct access when key management is undesirable, or over heavier financial data APIs when only spot price, volume, and market cap are needed.

## Known failure modes

- Unknown symbol or ID returns found:false for that entry without failing the whole request
- More than 25 coins requested may be rejected or truncated
- Payment failure (insufficient USDC balance) returns HTTP 402 before data is returned
- CoinGecko upstream outage may cause stale or missing data
- Malformed query string (invalid characters) may cause a 400 error

## How this service works

Pay-per-call tools for AI agents. USDC on Base or Solana via x402 v2; no keys, no accounts.

## Output

Returns a JSON object with an array of price records for each requested coin, each containing: resolved CoinGecko ID, USD price, 24h USD volume, 24h price change percentage, USD market cap, last updated timestamp, and whether the coin was found. Also includes total count, source attribution (CoinGecko simple/price), and the fetch timestamp.

## 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": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Comma-separated CoinGecko ids (e.g. solana) or symbols (e.g. btc), max 25"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ids": [
   "solana",
   "bitcoin",
   "ethereum"
  ],
  "count": 3,
  "found": 3,
  "prices": [
   {
    "id": "bitcoin",
    "usd": 81738,
    "found": true,
    "query": "btc",
    "resolvedBy": "symbol",
    "usd_24h_vol": 33484523823,
    "lastUpdatedAt": "2026-10-14T21:52:59.000Z",
    "usd_24h_change": -2.03,
    "usd_market_cap": 1642903115560
   }
  ],
  "source": "CoinGecko simple/price",
  "fetchedAt": "2026-10-14T21:53:21.372Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-agent-tools-crypto-price-lookup-15057f5e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent-tools.vercel.app](https://www.zero.xyz/host/x402-agent-tools.vercel.app/llms.txt)