# CoinMarketCap API

**Provider:** CoinMarketCap
**Category:** finance
**Base URL:** `https://pro-api.coinmarketcap.com/v1`
**Auth:** api-key — `X-CMC_PRO_API_KEY: YOUR_API_KEY`
**Rate Limit:** 30 calls/min (free)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://coinmarketcap.com/api/documentation/v1/

## Description

CoinMarketCap is the world's most-referenced cryptocurrency data provider, tracking 9,500+ cryptocurrencies across 700+ exchanges. The API provides real-time and historical price, market cap, and volume data, global crypto market metrics, Fear & Greed Index, category performance, airdrops calendar, and on-chain DEX trading data. Widely used in crypto apps, media, and institutional research.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest` | Latest crypto listings sorted by market cap |
| GET | `https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest` | Real-time prices and market data by symbol or ID |
| GET | `https://pro-api.coinmarketcap.com/v1/global-metrics/quotes/latest` | Global crypto market statistics |
| GET | `https://pro-api.coinmarketcap.com/v1/cryptocurrency/info` | Metadata: logo, description, URLs, tags |
| GET | `https://pro-api.coinmarketcap.com/v1/cryptocurrency/market-pairs/latest` | Active market pairs for a cryptocurrency |

## Authentication

Pass your API key in the X-CMC_PRO_API_KEY request header.

```
X-CMC_PRO_API_KEY: YOUR_API_KEY
```

## Sample Request

```bash
curl "https://pro-api.coinmarketcap.com/v1/cryptocurrency/quotes/latest?symbol=BTC,ETH&convert=USD" -H "X-CMC_PRO_API_KEY: $CMC_API_KEY"
```

## Sample Response

```json
{
  "data": {
    "BTC": {
      "name": "Bitcoin",
      "symbol": "BTC",
      "quote": {
        "USD": {
          "price": 67845.23,
          "market_cap": 1334567890123,
          "percent_change_24h": 2.45
        }
      }
    }
  }
}
```

## Pricing Details

Basic (free): 10k credits/month. Hobbyist $29/mo: 40k credits/month. Startup $79/mo: 200k credits/month. Standard $399/mo: 1M credits/month.

---

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