# CoinGecko API

> CoinGecko API on Apizie: 8 endpoints (Categories, Exchanges, Supported vs Currencies, Global, …) returned as clean JSON through one API key. 8 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/finance:coingecko/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `finance:coingecko`
- Category: Finance
- Status: live
- Source: https://coingecko.com
- Page: https://zieapi.vercel.app/api/finance/coingecko
- OpenAPI: https://zieapi.vercel.app/api/finance/coingecko/openapi.json

Crypto prices, market rankings, categories, exchanges and derivatives from CoinGecko's public API.

## Endpoints

### Categories
`GET https://zieapi.vercel.app/v1/finance:coingecko/categories`

| Parameter | Type | Required | Description |
|---|---|---|---|
| order | string | no |  |
| query | string | no | Filter categories by name |
| limit | integer | no |  |

### Exchanges
`GET https://zieapi.vercel.app/v1/finance:coingecko/exchanges`

| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | no |  |
| limit | integer | no |  |

### Supported vs Currencies
`GET https://zieapi.vercel.app/v1/finance:coingecko/vs-currencies`

### Global
`GET https://zieapi.vercel.app/v1/finance:coingecko/global`

| Parameter | Type | Required | Description |
|---|---|---|---|
| vsCurrency | string | no | Only return totals in this currency, e.g. usd |
| limit | integer | no | Max dominance entries |

### Coins Markets
`GET https://zieapi.vercel.app/v1/finance:coingecko/coins-markets`

| Parameter | Type | Required | Description |
|---|---|---|---|
| vsCurrency | string | no |  |
| ids | string | no | Restrict to these coin ids (comma-separated) |
| category | string | no | CoinGecko category id, e.g. layer-1 |
| order | string | no |  |
| priceChangePercentage | string | no | Extra change windows |
| precision | string | no |  |
| page | integer | no |  |
| limit | integer | no |  |

### Simple Price
`GET https://zieapi.vercel.app/v1/finance:coingecko/simple-price`

| Parameter | Type | Required | Description |
|---|---|---|---|
| ids | string | yes | Comma-separated CoinGecko coin ids |
| vsCurrencies | string | no | Comma-separated quote currencies |
| includeMarketCap | string | no |  |
| include24hVol | string | no |  |
| include24hChange | string | no |  |
| precision | string | no | Decimal places (0-18) or 'full' |

### Derivatives
`GET https://zieapi.vercel.app/v1/finance:coingecko/derivatives`

| Parameter | Type | Required | Description |
|---|---|---|---|
| market | string | no | Filter by exchange/market name |
| indexId | string | no |  |
| symbol | string | no | Filter by contract symbol (substring) |
| contractType | string | no |  |
| page | integer | no |  |
| limit | integer | no |  |

### Ping
`GET https://zieapi.vercel.app/v1/finance:coingecko/ping`

## Example
```
curl "https://zieapi.vercel.app/v1/finance:coingecko/categories" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the CoinGecko API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/finance:coingecko/categories with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the CoinGecko API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the CoinGecko API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key finance:coingecko.

### What is the status of the CoinGecko API?
Live: works with just an Apizie key