# CoinGecko Token Price Lookup

> CoinGecko Token Price Lookup is a paid API for AI agents from registry.frames.ag, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Fetches real-time prices for one or more cryptocurrency tokens in any fiat or crypto currency, with optional 24h volume, market cap, and change data.

## Facts

- Endpoint: POST https://registry.frames.ag/api/service/coingecko/api/price?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-token-price-lookup-4168fc2b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xLezrVwLF0u6n5a1TK8IN

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-token-price-lookup-4168fc2b -d '<json body>'
```

Example prompt: What are the current prices of Bitcoin, Ethereum, and Solana in USD, and include their 24-hour price change and market cap?

## When to prefer this

Choose this endpoint when you need real-time cryptocurrency price data for one or more tokens in fiat or crypto denominations, especially when you also want enriched market data like 24h volume, market cap, or price change. It is well-suited for portfolio trackers, trading dashboards, DeFi applications, or any workflow requiring up-to-date token valuations via a simple POST call with CoinGecko-style token IDs.

## Known failure modes

- Invalid or misspelled token IDs return empty results or an error
- Unsupported vs_currencies values result in a missing or null field
- Rate limiting or upstream CoinGecko downtime may cause 5xx responses
- Empty ids string triggers a validation error due to minLength:1 constraint
- Request with no vs_currencies may default to USD or return an error depending on implementation

## How this service works

Get token prices in any fiat/crypto currency

## Output

A JSON object keyed by token ID, containing the price in each requested currency, and optionally the 24h trading volume, market capitalization, 24h price change percentage, and last updated Unix timestamp for each token.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ids": {
   "type": "string",
   "minLength": 1
  },
  "vs_currencies": {
   "type": "string"
  },
  "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-token-price-lookup-4168fc2b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from registry.frames.ag](https://www.zero.xyz/host/registry.frames.ag/llms.txt)