# x402node Crypto Price Lookup (CoinGecko)

> x402node Crypto Price Lookup (CoinGecko) is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Returns current cryptocurrency prices, 24h change, market cap, volume, and last update timestamp for one or more coins in one or more fiat currencies via CoinGecko free tier.

## Facts

- Endpoint: GET https://api.x402node.dev/finance/crypto
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-x402node-dev-3344c4b7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6_L9RiTsqopKt7w2SjNYt

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 api-x402node-dev-3344c4b7
```

Example prompt: What are the current prices of bitcoin, ethereum, and solana in USD, including their 24-hour change and market cap?

## When to prefer this

Choose this endpoint when you need current spot prices, 24h change, market cap, and volume for one or more cryptocurrencies against one or more fiat currencies, especially in AI agent workflows for portfolio tracking or on-chain context. Prefer over a generic market data API when you need multi-coin, multi-currency lookups in a single call at low cost ($0.008 USDC).

## Known failure modes

- Invalid coin ID returns error or empty result
- Unsupported vs_currency returns error
- CoinGecko free tier rate limits may cause 429 errors under high call volume
- Network or upstream CoinGecko outage returns 5xx
- Malformed query parameters may return 400 or unexpected empty response

## How this service works

x402node — precise, deterministic developer and data tools for AI agents. Chain data, parsing, crypto, conversion. Pay-per-call over x402, settled in USDC on Base.

## Output

A JSON object containing, for each requested coin, the current price in the requested currency or currencies, 24-hour percentage change, market cap, trading volume, and the timestamp of the last data update — sourced from CoinGecko's free tier.

## 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",
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "CoinGecko id(s), e.g. bitcoin or bitcoin,ethereum. Use this for coins not covered by ticker mapping. Alias: ids."
      },
      "vs": {
       "type": "string",
       "description": "Quote currency, default usd. e.g. usd, eur, jpy. Comma-separated allowed."
      },
      "symbol": {
       "type": "string",
       "description": "Token ticker(s), e.g. BTC or BTC,ETH,SOL (batch). Common tickers are auto-mapped. Alias: symbols."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-x402node-dev-3344c4b7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)