# CoinGecko Live Spot Price Lookup

> CoinGecko Live Spot Price Lookup is a paid API for AI agents from agent402.tools, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14, last successful call 2026-07-01).

Fetches live spot prices (and optional 24-hour % change) for one or more cryptocurrencies via CoinGecko's Simple Price endpoint, identified by CoinGecko ID slug.

## Facts

- Endpoint: POST https://agent402.tools/api/price-coingecko
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Last successful call: 2026-07-01
- Success rate: 67% of calls made through Zero
- Activations on Zero: 9
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-live-spot-price-lookup-3aa398fc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3gAP3lbghwYJCLegqw490

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-live-spot-price-lookup-3aa398fc -d '<json body>'
```

Example prompt: What are the current prices of bitcoin, ethereum, and solana in USD right now, and include how much each has changed in the last 24 hours?

## When to prefer this

Use this endpoint when you need live, real-time cryptocurrency spot prices for one or more coins identified by their CoinGecko ID slugs, especially when you want optional 24-hour change data and flexible quote currency support. Prefer this over exchange-specific APIs when you need a neutral, aggregated price source across many coins simultaneously.

## Known failure modes

- Unknown coin ID slug returns no data or error for that entry
- Invalid vsCurrency value causes a CoinGecko API error
- Requesting more than 25 coin IDs may be rejected or produce incomplete results
- CoinGecko public API rate limits may cause transient failures under high load
- Network timeout if CoinGecko upstream is slow

## How this service works

Live spot price (and optional 24-hour change) for one or more coins from CoinGecko's public Simple Price endpoint. Identify coins by their CoinGecko ID slug (bitcoin, ethereum, solana, usd-coin, …). Defaults to USD; pass a `vsCurrency` to denominate in EUR, JPY, ETH, BTC, etc.

## Output

A JSON object mapping each requested CoinGecko coin ID to its current spot price in the specified quote currency, and optionally the 24-hour percentage change for each coin.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ids": {
   "type": "array",
   "description": "CoinGecko coin IDs (e.g. bitcoin, ethereum, solana). 1-25 entries."
  },
  "vsCurrency": {
   "type": "string",
   "description": "Quote currency (default usd). Supports any CoinGecko vs_currencies value."
  },
  "include24hChange": {
   "type": "boolean",
   "description": "Include 24h % change in the response (default false)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "prices": [
   {
    "id": "bitcoin",
    "price": 67000.12,
    "change24h": null
   },
   {
    "id": "ethereum",
    "price": 3500.05,
    "change24h": null
   }
  ],
  "vsCurrency": "usd"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-live-spot-price-lookup-3aa398fc/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)