# CoinGecko Price Lookup

> CoinGecko Price Lookup is a paid API for AI agents from stablecrypto.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches current prices for one or more cryptocurrencies in specified fiat or crypto currencies, with optional market stats

## Facts

- Endpoint: POST https://stablecrypto.dev/api/coingecko/price
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-price-lookup-b4aa0506
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dYf8vpQYv-T6sMZ10HAGY

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-price-lookup-b4aa0506 -d '<json body>'
```

Example prompt: What are the current prices of bitcoin and ethereum in USD and EUR, and include their 24-hour price changes and market caps?

## When to prefer this

Use this endpoint when you need current spot prices for one or more specific cryptocurrencies identified by CoinGecko coin IDs, especially when you also want supplementary market data like volume, market cap, or 24hr change in a single call. Prefer this over symbol-based or contract-address-based lookup when you already know the CoinGecko coin ID.

## Known failure modes

- Invalid coin ID returns null or missing entry for that coin
- Unsupported vs_currency causes missing price data
- Invalid precision value may cause a 400 error
- Rate limiting or upstream CoinGecko API downtime returns a 5xx error
- Empty ids or vs_currencies array may return an empty object or error

## How this service works

Pay-per-request access to CoinGecko, DefiLlama, Alchemy, and Etherscan APIs. No auth, no subscriptions.

## Output

A map of each coin ID (e.g. 'bitcoin') to an object containing prices in each requested currency, plus optional fields for 24hr volume, market cap, 24hr change percentage, and last updated timestamp, depending on which flags were set in the request.

## Example request

```json
{
 "ids": [
  "bitcoin",
  "ethereum"
 ],
 "vs_currencies": [
  "usd",
  "eur"
 ],
 "include_24hr_vol": true,
 "include_market_cap": true,
 "include_24hr_change": true,
 "include_last_updated_at": true
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ids": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Coin IDs (e.g. [\"bitcoin\", \"ethereum\"])"
  },
  "precision": {
   "type": "string",
   "description": "Decimal precision (0-18)"
  },
  "vs_currencies": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Target currencies (e.g. [\"usd\", \"eur\"])"
  },
  "include_24hr_vol": {
   "type": "boolean"
  },
  "include_market_cap": {
   "type": "boolean"
  },
  "include_24hr_change": {
   "type": "boolean"
  },
  "include_last_updated_at": {
   "type": "boolean"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-price-lookup-b4aa0506/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablecrypto.dev](https://www.zero.xyz/host/stablecrypto.dev/llms.txt)