# CoinGecko on Onekey

> 13 endpoints for CoinGecko (12 stable, 1 beta), 1 to 5 credits each. Category: Finance & markets. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.

Page: https://onekey.dev/platforms/coingecko
Reference (Markdown): https://onekey.dev/docs/api/coingecko.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 13 mapped CoinGecko endpoints return each:

- `entity.name` (string): 9
- `entity.id` (string): 7
- `media.thumbnailUrl` (URL): 7
- `entity.date` (ISO 8601 date): 6
- `market.price` (number): 5
- `market.symbol` (string): 5
- `market.volume24h` (number): 5
- `market.change24hPct` (number): 4
- `market.marketCap` (number): 4
- `market.marketCapRank` (integer): 4
- `entity.category` (string): 3
- `entity.url` (URL): 3
- `entity.description` (string): 2
- `entity.createdAt` (ISO 8601 date): 1
- `market.close` (number): 1
- `market.high` (number): 1
- `market.low` (number): 1
- `market.open` (number): 1
- plus 28 platform-specific fields under `ext.`

## Endpoints

### coingecko.categories

Coin categories with aggregate market cap and 24h volume.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/coingecko/categories` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.name`, `market.marketCap`, `market.change24hPct`, `market.volume24h`, `entity.date`
- Reference: https://onekey.dev/docs/api/coingecko/categories.md

### coingecko.coin

Coin profile with live market data (price, market cap, supply, ATH).
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/coingecko/coin?id=bitcoin` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `id` (string, required): CoinGecko coin id, e.g. bitcoin
- Fields returned: `entity.id`, `entity.name`, `market.symbol`, `entity.description`, `entity.url`, `media.thumbnailUrl`, `entity.createdAt`, `entity.category`, `market.marketCapRank`, `market.price`, `market.marketCap`, `market.volume24h`, `market.change24hPct`, `entity.date`, `ext.circulatingSupply`, `ext.totalSupply`, `ext.ath`
- Reference: https://onekey.dev/docs/api/coingecko/coin.md

### coingecko.defi_global

Global DeFi market summary (market cap, dominance, top coin).
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/coingecko/defi_global` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `market.volume24h`, `entity.name`, `ext.defiMarketCap`, `ext.ethMarketCap`, `ext.defiToEthRatio`, `ext.dominancePct`, `ext.topCoinDominancePct`
- Reference: https://onekey.dev/docs/api/coingecko/defi_global.md

### coingecko.exchange

One exchange: trust score, 24h BTC volume, country, links.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/coingecko/exchange?id=binance` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `id` (string, required): CoinGecko coin id, e.g. bitcoin
- Fields returned: `entity.name`, `entity.description`, `entity.category`, `entity.url`, `media.thumbnailUrl`, `ext.yearEstablished`, `ext.trustScore`, `ext.trustRank`, `ext.volume24hBtc`
- Reference: https://onekey.dev/docs/api/coingecko/exchange.md

### coingecko.exchange_rates

BTC-denominated exchange rates for fiat, crypto and commodities.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/coingecko/exchange_rates` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `ext.usdPerBtc`, `ext.ethPerBtc`, `ext.eurPerBtc`, `ext.gbpPerBtc`, `ext.jpyPerBtc`, `ext.inrPerBtc`, `ext.xauPerBtc`
- Reference: https://onekey.dev/docs/api/coingecko/exchange_rates.md

### coingecko.exchanges

Crypto exchanges ranked by trust score.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/coingecko/exchanges?per_page=10` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `per_page` (string, optional, default 20): Rows per page (1-100)
  - `page` (string, optional, default 1): Page number
- Fields returned: `entity.id`, `entity.name`, `entity.category`, `entity.url`, `media.thumbnailUrl`, `ext.yearEstablished`, `ext.trustScore`, `ext.trustRank`, `ext.volume24hBtc`
- Reference: https://onekey.dev/docs/api/coingecko/exchanges.md

### coingecko.global

Global crypto market: total market cap, volume, BTC/ETH dominance.
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/coingecko/global` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `market.change24hPct`, `entity.date`, `ext.activeCoins`, `ext.markets`, `ext.marketCapUsd`, `ext.volumeUsd`, `ext.btcDominancePct`, `ext.ethDominancePct`
- Reference: https://onekey.dev/docs/api/coingecko/global.md

### coingecko.history

Coin snapshot (price, market cap, volume) on a past date (public API: last 365 days only).
- Price: 1 credit per fresh call. Status: stable. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/coingecko/history?id=bitcoin&date=01-09-2026` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `id` (string, required): CoinGecko coin id, e.g. bitcoin
  - `date` (string, required): Date dd-mm-yyyy (within the last 365 days)
- Fields returned: `entity.id`, `entity.name`, `market.symbol`, `media.thumbnailUrl`, `market.price`, `market.marketCap`, `market.volume24h`
- Reference: https://onekey.dev/docs/api/coingecko/history.md

### coingecko.market_chart

Price time series (price points) for a coin over N days.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/coingecko/market_chart?id=bitcoin` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `id` (string, required): CoinGecko coin id, e.g. bitcoin
  - `vs_currency` (string, optional, default usd): Quote currency, e.g. usd
  - `days` (string, optional, default 7): Range in days (1-365)
- Fields returned: `entity.date`, `market.price`
- Reference: https://onekey.dev/docs/api/coingecko/market_chart.md

### coingecko.markets

Top coins by market cap with prices, volume and 24h change.
- Price: 5 credits per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/coingecko/markets?vs_currency=usd&per_page=10` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `vs_currency` (string, optional, default usd): Quote currency, e.g. usd
  - `per_page` (string, optional, default 20): Rows per page (1-100)
  - `page` (string, optional, default 1): Page number
- Fields returned: `entity.id`, `entity.name`, `market.symbol`, `media.thumbnailUrl`, `market.marketCapRank`, `market.price`, `market.marketCap`, `market.volume24h`, `market.change24hPct`, `entity.date`, `ext.high24h`, `ext.low24h`, `ext.circulatingSupply`, `ext.ath`
- Reference: https://onekey.dev/docs/api/coingecko/markets.md

### coingecko.ohlc

OHLC candles for a coin (days: 1,7,14,30,90,180,365).
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/coingecko/ohlc?id=bitcoin` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `id` (string, required): CoinGecko coin id, e.g. bitcoin
  - `vs_currency` (string, optional, default usd): Quote currency, e.g. usd
  - `days` (string, optional, default 7): Range in days
- Fields returned: `entity.date`, `market.open`, `market.high`, `market.low`, `market.close`
- Reference: https://onekey.dev/docs/api/coingecko/ohlc.md

### coingecko.search

Search coins by name or symbol.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/coingecko/search?q=solana` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Search text
- Fields returned: `entity.id`, `entity.name`, `market.symbol`, `media.thumbnailUrl`, `market.marketCapRank`
- Reference: https://onekey.dev/docs/api/coingecko/search.md

### coingecko.trending

Trending coins on CoinGecko in the last 24h.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/coingecko/trending` with header `x-api-key: YOUR_API_KEY`
- Parameters: none
- Fields returned: `entity.id`, `entity.name`, `market.symbol`, `media.thumbnailUrl`, `market.marketCapRank`, `market.price`, `ext.trendRank`
- Reference: https://onekey.dev/docs/api/coingecko/trending.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/coingecko/coin?id=bitcoin" \
  -H "x-api-key: YOUR_API_KEY"
```