Loading...
Loading...
API reference for CoinMarketCap cryptocurrency endpoints including quotes, listings, OHLCV, trending, and categories. Use this skill whenever the user mentions CMC API, asks how to get crypto data programmatically, wants to build price integrations, or needs REST endpoint documentation. This is the go-to reference for any CMC cryptocurrency API question. Trigger: "CMC API", "coinmarketcap api", "crypto price API", "get bitcoin price via API", "/cmc-api-crypto"
npx skill4agent add coinmarketcap-official/skills-for-ai-agents-by-coinmarketcap cmc-api-cryptocurl -X GET "https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest" \
-H "X-CMC_PRO_API_KEY: your-api-key"https://pro-api.coinmarketcap.com| Endpoint | Description | Reference |
|---|---|---|
| GET /v1/cryptocurrency/categories | List all categories with market metrics | categories.md |
| GET /v1/cryptocurrency/category | Single category details | categories.md |
| GET /v1/cryptocurrency/listings/historical | Historical listings snapshot | listings.md |
| GET /v1/cryptocurrency/listings/latest | Current listings with market data | listings.md |
| GET /v1/cryptocurrency/listings/new | Newly added cryptocurrencies | listings.md |
| GET /v1/cryptocurrency/map | Map names/symbols to CMC IDs | map.md |
| GET /v1/cryptocurrency/trending/gainers-losers | Top gainers and losers | trending.md |
| GET /v1/cryptocurrency/trending/latest | Currently trending coins | trending.md |
| GET /v1/cryptocurrency/trending/most-visited | Most visited on CMC | trending.md |
| GET /v2/cryptocurrency/info | Static metadata (logo, description, URLs) | info.md |
| GET /v2/cryptocurrency/market-pairs/latest | Trading pairs for a coin | market-pairs.md |
| GET /v2/cryptocurrency/ohlcv/historical | Historical OHLCV candles | ohlcv.md |
| GET /v2/cryptocurrency/ohlcv/latest | Latest OHLCV data | ohlcv.md |
| GET /v2/cryptocurrency/price-performance-stats/latest | Price performance stats | price-performance.md |
| GET /v2/cryptocurrency/quotes/latest | Latest price quotes | quotes.md |
| GET /v3/cryptocurrency/quotes/historical | Historical price quotes | quotes.md |
/v1/cryptocurrency/map/v2/cryptocurrency/quotes/latest# Step 1: Get CMC ID for ETH
curl -X GET "https://pro-api.coinmarketcap.com/v1/cryptocurrency/map?symbol=ETH" \
-H "X-CMC_PRO_API_KEY: your-api-key"
# Step 2: Get price quote (using id=1027 for ETH)
curl -X GET "https://pro-api.coinmarketcap.com/v2/cryptocurrency/quotes/latest?id=1027" \
-H "X-CMC_PRO_API_KEY: your-api-key"curl -X GET "https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest?limit=100&sort=market_cap" \
-H "X-CMC_PRO_API_KEY: your-api-key"curl -X GET "https://pro-api.coinmarketcap.com/v3/cryptocurrency/quotes/historical?id=1&time_start=2024-01-01&time_end=2024-01-31&interval=daily" \
-H "X-CMC_PRO_API_KEY: your-api-key"curl -X GET "https://pro-api.coinmarketcap.com/v2/cryptocurrency/info?id=1,1027" \
-H "X-CMC_PRO_API_KEY: your-api-key"| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad request (invalid parameters) |
| 401 | Unauthorized (invalid API key) |
| 403 | Forbidden (endpoint not available on your plan) |
| 429 | Rate limit exceeded |
| 500 | Server error |
X-CMC_PRO_API_KEY_CREDITS_USEDX-CMC_PRO_API_KEY_CREDITS_LEFT/map{
"status": {
"timestamp": "2024-01-15T12:00:00.000Z",
"error_code": 400,
"error_message": "Invalid value for 'id'",
"credit_count": 0
}
}{
"status": {
"timestamp": "2024-01-15T12:00:00.000Z",
"error_code": 0,
"error_message": null,
"credit_count": 1
},
"data": { ... }
}references/