mcpField
C
cmc-api-market

cmc-api-market

github.com/opencmcData & databases75120 installsUpdated 5d ago
Repository

About cmc-api-market

A CoinMarketCap API skill for cryptocurrency market-wide data, aimed at analysts and developers building market views or data applications. It covers sentiment, indices, community activity, charts, conversion, and API usage.

Key features

  1. 01Global market cap and BTC dominance
  2. 02Fear and Greed values and history
  3. 03CMC100 and CMC20 index data
  4. 04Community trends and latest content
  5. 05OHLCV candles and price time series
  6. 06Currency conversion and API usage

Use cases

  1. 01Assess sentiment alongside global metrics
  2. 02Compare historical CMC100 and CMC20 performance
  3. 03Build price charts from OHLCV data
  4. 04Track trending tokens and discussion topics

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/opencmc/skills-for-ai-agents-by-coinmarketcap --skill cmc-api-market

After installing, type/cmc-api-marketin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
community.md
content.md
fear-greed.md
global-metrics.md
indices.md
kline.md
tools.md
use-cases.md

Details

From the project README

CoinMarketCap Market API Skill

This skill covers market-wide cryptocurrency data including global metrics, sentiment indicators, market indices, community activity, news content, charting data, and utility endpoints.

Authentication

All requests require the X-CMC_PRO_API_KEY header.

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

Common Use Cases

See use-cases.md for goal-based guidance on which endpoint to use:

  1. Get current market sentiment (Fear & Greed)
  2. Get total crypto market cap
  3. Get BTC dominance
  4. Track market cap history
  5. Track Fear & Greed history
  6. Get CMC100 index performance
  7. Compare CMC100 vs CMC20
  8. Get OHLCV candlestick data for charts
  9. Get simple price time series
  10. Get community trending tokens
  11. Get trending discussion topics
  12. Get latest crypto news
  13. Convert currency amounts
  14. Check API usage and limits
  15. Get fiat currency IDs

API Overview

Global Metrics
EndpointDescriptionReference
GET /v1/global-metrics/quotes/historicalHistorical global market metricsglobal-metrics.md
GET /v1/global-metrics/quotes/latestLatest total market cap, BTC dominanceglobal-metrics.md
Fear and Greed Index
EndpointDescriptionReference
GET /v3/fear-and-greed/historicalHistorical fear/greed valuesfear-greed.md
GET /v3/fear-and-greed/latestCurrent market sentiment scorefear-greed.md
Market Indices
EndpointDescriptionReference
GET /v3/index/cmc100-historicalCMC100 index historyindices.md
GET /v3/index/cmc100-latestCMC100 current valueindices.md
GET /v3/index/cmc20-historicalCMC20 index historyindices.md
GET /v3/index/cmc20-latestCMC20 current valueindices.md
Community
EndpointDescriptionReference
GET /v1/community/trending/tokenTrending tokens by community activitycommunity.md
GET /v1/community/trending/topicTrending discussion topicscommunity.md
Content
EndpointDescriptionReference
GET /v1/content/latestLatest news and Alexandria articlescontent.md
GET /v1/content/posts/commentsComments on a specific postcontent.md
GET /v1/content/posts/latestLatest community postscontent.md
GET /v1/content/posts/topTop ranked community postscontent.md
K-Line Charts
EndpointDescriptionReference
GET /v1/k-line/candlesOHLCV candlestick datakline.md
GET /v1/k-line/pointsTime series price/market cap pointskline.md
Tools
EndpointDescriptionReference
GET /v1/fiat/mapMap fiat currencies to CMC IDstools.md
GET /v1/key/infoAPI key usage and plan detailstools.md
GET /v2/tools/price-conversionConvert between currenciestools.md

Common Workflows

Get Market Sentiment Overview
  1. Fetch fear/greed index: /v3/fear-and-greed/latest
  2. Get global metrics: /v1/global-metrics/quotes/latest
  3. Combine for sentiment analysis with market cap context
Track Market Index Performance
  1. Get current CMC100 value: /v3/index/cmc100-latest
  2. Fetch historical data: /v3/index/cmc100-historical
  3. Compare performance over time
Monitor Community Activity
  1. Check trending tokens: /v1/community/trending/token
  2. Review trending topics: /v1/community/trending/topic
  3. Read latest posts: /v1/content/posts/top
Build Price Charts
  1. Fetch OHLCV candles: /v1/k-line/candles
  2. Use interval parameter for timeframe (1h, 4h, 1d)
  3. Plot candlestick chart with returned data
Currency Conversion
  1. Get fiat currency IDs: /v1/fiat/map
  2. Convert amounts: /v2/tools/price-conversion

Error Handling

Status CodeMeaningAction
400Bad RequestCheck parameter values and format
401UnauthorizedVerify API key is valid
403ForbiddenEndpoint not available on your plan
429Rate LimitedWait and retry with backoff
500Server ErrorRetry after delay
Error Response Format
{
  "status": {
    "error_code": 400,
    "error_message": "Invalid value for 'id'"
  }
}
Rate Limit Headers

Check these response headers to monitor usage:

  1. X-CMC_PRO_API_KEY_CREDITS_USED - Credits consumed
  2. X-CMC_PRO_API_KEY_CREDITS_REMAINING - Credits left
  3. X-CMC_PRO_API_KEY_RATE_LIMIT - Requests per minute limit

Response Format

All endpoints return JSON with this structure:

{
  "status": {
    "timestamp": "2024-01-15T10:30:00.000Z",
    "error_code": 0,
    "error_message": null,
    "credit_count": 1
  },
  "data": { }
}

Tips

  1. Use the /v1/key/info endpoint to check your plan limits before heavy usage
  2. Cache global metrics data as it updates every few minutes
  3. Fear/greed index updates daily, no need for frequent polling
  4. K-line data supports multiple intervals for different chart timeframes
  5. Community trending data refreshes periodically throughout the day

Comments

Markdown supported