GitHub repo: coinmarketcap-official/skills-for-ai-agents-by-CoinMarketCap
Market-wide cryptocurrency data including global metrics, sentiment indicators, market indices, community activity, news content, charting data, and utility endpoints.
Authentication
curl -X GET "https://pro-api.coinmarketcap.com/v1/global-metrics/quotes/latest" \ -H "X-CMC_PRO_API_KEY: your-api-key"
Get your API key at https://pro.coinmarketcap.com/login
Base URL: https://pro-api.coinmarketcap.com
API Overview
Global Metrics
Endpoint Description GET /v1/global-metrics/quotes/historical Historical global market metrics GET /v1/global-metrics/quotes/latest Latest total market cap, BTC dominance
Fear and Greed Index
Endpoint Description GET /v3/fear-and-greed/historical Historical fear/greed values GET /v3/fear-and-greed/latest Current market sentiment score
Market Indices
Endpoint Description GET /v3/index/cmc100-historical CMC100 index history GET /v3/index/cmc100-latest CMC100 current value GET /v3/index/cmc20-historical CMC20 index history GET /v3/index/cmc20-latest CMC20 current value
Endpoint Description GET /v1/community/trending/token Trending tokens by community activity GET /v1/community/trending/topic Trending discussion topics
Content
Endpoint Description GET /v1/content/latest Latest news and Alexandria articles GET /v1/content/posts/comments Comments on a specific post GET /v1/content/posts/latest Latest community posts GET /v1/content/posts/top Top ranked community posts
K-Line Charts
Endpoint Description GET /v1/k-line/candles OHLCV candlestick data GET /v1/k-line/points Time series price/market cap points
Tools
Endpoint Description GET /v1/fiat/map Map fiat currencies to CMC IDs GET /v1/key/info API key usage and plan details GET /v2/tools/price-conversion Convert between currencies
Common Workflows
Get Market Sentiment Overview
Fetch fear/greed index: /v3/fear-and-greed/latest
Get global metrics: /v1/global-metrics/quotes/latest
Combine for sentiment analysis with market cap context
Track Market Index Performance
Get current CMC100 value: /v3/index/cmc100-latest
Fetch historical data: /v3/index/cmc100-historical
Compare performance over time
Check trending tokens: /v1/community/trending/token
Review trending topics: /v1/community/trending/topic
Read latest posts: /v1/content/posts/top
Build Price Charts
Fetch OHLCV candles: /v1/k-line/candles
Use interval parameter for timeframe (1h, 4h, 1d)
Plot candlestick chart with returned data
Common Use Cases
Get current market sentiment (Fear & Greed)
Get total crypto market cap
Get BTC dominance
Track market cap history
Track Fear & Greed history
Get CMC100 index performance
Compare CMC100 vs CMC20
Get OHLCV candlestick data for charts
Get community trending tokens
Get trending discussion topics
Get latest crypto news
Convert currency amounts
Check API usage and limits
Tips
Use /v1/key/info to check your plan limits before heavy usage
Cache global metrics data as it updates every few minutes
Fear/greed index updates daily, no need for frequent polling
K-line data supports multiple intervals for different chart timeframes
Community trending data refreshes periodically throughout the day
