# CoinGecko Real-Time Spot Price Lookup

> CoinGecko Real-Time Spot Price Lookup is a paid API for AI agents from coingecko.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Returns real-time spot prices for one or more crypto coins in one or more fiat/crypto currencies using CoinGecko coin IDs.

## Facts

- Endpoint: GET https://coingecko.use.x402atlas.com/price?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-real-time-spot-price-lookup-829ab16e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QcNXJiQ-UT3F9arcTMRTZ

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 coingecko-real-time-spot-price-lookup-829ab16e
```

Example prompt: What are the current prices of bitcoin, ethereum, and solana in both USD and EUR right now?

## When to prefer this

Use this endpoint when you need the current spot price of one or many specific coins in one or many currencies and don't need historical data, OHLC candles, or full market metadata. It is the fastest and cheapest option for simple price lookups by CoinGecko coin ID.

## Known failure modes

- Invalid coin ID returns empty object or error — use exact CoinGecko slugs like 'bitcoin' not 'BTC'
- Invalid vs_currencies value returns error or empty prices
- Missing required query parameters (ids or vs_currencies) returns 400 or validation error
- Rate limiting or payment failure returns 402 or 429
- Network timeout if many coins are requested simultaneously

## How this service works

Crypto token price in USD, EUR and more — real-time spot prices for one or many coins by CoinGecko id (bitcoin, ethereum, solana).

## Output

A JSON object keyed by coin ID, each containing the requested currency prices as numeric values — e.g. {"bitcoin":{"usd":67000,"eur":61500},"ethereum":{"usd":3200,"eur":2950}}.

## 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": [
      "ids",
      "vs_currencies"
     ],
     "properties": {
      "ids": {
       "type": "string",
       "description": "Comma-separated CoinGecko coin-id slugs, lowercase, up to 50 ids (e.g. bitcoin,ethereum)"
      },
      "vs_currencies": {
       "type": "string",
       "description": "Comma-separated target currency codes, up to 50, alphanumeric (e.g. usd,eur,btc)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "quotes"
     ],
     "properties": {
      "quotes": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "id",
         "vs_currency",
         "price"
        ],
        "properties": {
         "id": {
          "type": "string",
          "description": "CoinGecko coin id slug"
         },
         "price": {
          "type": "number",
          "description": "Spot price"
         },
         "vs_currency": {
          "type": "string",
          "description": "Currency code the price is quoted in"
         }
        }
       },
       "description": "One row per requested id x currency pair that had upstream data"
      },
      "queried_at": {
       "type": "string",
       "format": "date-time",
       "description": "UTC timestamp the upstream was queried"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "quotes": [
   {
    "id": "bitcoin",
    "price": 67000,
    "vs_currency": "usd"
   },
   {
    "id": "ethereum",
    "price": 3500,
    "vs_currency": "usd"
   }
  ],
  "queried_at": "2026-06-08T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-real-time-spot-price-lookup-829ab16e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coingecko.use.x402atlas.com](https://www.zero.xyz/host/coingecko.use.x402atlas.com/llms.txt)