# CoinGecko API

**Provider:** CoinGecko
**Category:** finance
**Base URL:** `https://api.coingecko.com/api/v3`
**Auth:** api-key — `x-cg-demo-api-key: CG-...`
**Rate Limit:** 30 calls/min (free)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://docs.coingecko.com/reference/introduction

## Description

CoinGecko is the leading independent cryptocurrency data aggregator, tracking 15,000+ coins across 900+ exchanges. The API provides real-time prices, market caps, trading volumes, historical data, OHLC candles, exchange data, DeFi metrics, and NFT floor prices. Widely used in crypto dashboards, wallets, and portfolio trackers.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.coingecko.com/api/v3/simple/price` | Get current price for one or more coins |
| GET | `https://api.coingecko.com/api/v3/coins/markets` | List coins with market data sorted by rank |
| GET | `https://api.coingecko.com/api/v3/coins/{id}/market_chart` | Historical market data (price, volume, market cap) |
| GET | `https://api.coingecko.com/api/v3/coins/{id}/ohlc` | OHLC chart data for a coin |
| GET | `https://api.coingecko.com/api/v3/exchanges` | List all crypto exchanges with volume data |
| GET | `https://api.coingecko.com/api/v3/global` | Global crypto market overview stats |

## Authentication

Free tier requires no authentication. Demo and Pro plans use the x-cg-demo-api-key or x-cg-pro-api-key header.

```
x-cg-demo-api-key: CG-...
```

## Sample Request

```bash
curl "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum&vs_currencies=usd&include_24hr_change=true" -H "x-cg-demo-api-key: CG-..."
```

## Sample Response

```json
{
  "bitcoin": {
    "usd": 67234.50,
    "usd_24h_change": 2.34
  },
  "ethereum": {
    "usd": 3512.88,
    "usd_24h_change": 1.87
  }
}
```

## Pricing Details

Free: 30 calls/min, 10k/month. Demo $129/mo: 500 calls/min. Analyst $499/mo: 500 calls/min + premium endpoints. Lite $2,499/mo: 1,000 calls/min.

---

*Source: [API Map](https://apimap.dev/apis/coingecko/) — CC BY 4.0*