OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add opencmc/skills-for-ai-agents-by-coinmarketcap --skill cmc-api-crypto
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 skills add opencmc/skills-for-ai-agents-by-coinmarketcap --skill cmc-api-crypto
This skill covers the CoinMarketCap Cryptocurrency API endpoints for retrieving price data, market listings, historical quotes, trending coins, and token metadata.
All requests require an API key in the header.
Get your API key at: https://pro.coinmarketcap.com/login
See use-cases.md for goal-based guidance on which endpoint to use:
| 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| 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 |
Rate limits depend on your subscription plan. The response headers include:
X-CMC_PRO_API_KEY_CREDITS_USED - Credits used this callX-CMC_PRO_API_KEY_CREDITS_LEFT - Credits remainingInvalid ID: Ensure you use valid CMC IDs from the /map endpoint. Symbol lookups may return multiple matches.
Missing Required Parameter: Some endpoints require at least one identifier (id, slug, or symbol).
Plan Restrictions: Historical endpoints and some features require paid plans. Check your plan limits.
All responses follow this structure:
See the references/ directory for complete parameter and response documentation for each endpoint.
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"{
"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": { ... }
}