CoinMarketCap 市场 API 技能

该技能涵盖全市场范围的加密货币数据，包括全球指标、情绪指标、市场指数、社区活跃度、新闻内容、图表数据以及工具类端点。

身份验证

所有请求均需包含 X-CMC_PRO_API_KEY 请求头。

curl -X GET "https://pro-api.coinmarketcap.com/v1/global-metrics/quotes/latest" 
  -H "X-CMC_PRO_API_KEY: your-api-key"

获取您的 API 密钥地址：https://pro.coinmarketcap.com/login

基础 URL

https://pro-api.coinmarketcap.com

常见使用场景

详见 use-cases.md，其中按目标导向提供了各端点的选用建议：

1. 获取当前市场情绪（恐惧与贪婪指数）
2. 获取加密货币总市值
3. 获取 BTC 主导率（BTC dominance）
4. 追踪市值历史变化
5. 追踪恐惧与贪婪指数历史变化
6. 获取 CMC100 指数表现
7. 对比 CMC100 与 CMC20 表现
8. 获取用于图表绘制的 OHLCV K 线数据
9. 获取简化的价格时间序列数据
10. 获取社区热度上升的代币
11. 获取热门讨论话题
12. 获取最新加密货币新闻
13. 进行法币/代币金额换算
14. 查询 API 使用量及调用限额
15. 获取法币货币 ID 列表

API 概览

全球指标

恐惧与贪婪指数

市场指数

社区

内容

K 线图表

工具

常见工作流

获取市场情绪概览

1. 获取恐惧与贪婪指数：/v3/fear-and-greed/latest
2. 获取全球指标：/v1/global-metrics/quotes/latest
3. 结合两者进行带市值背景的情绪分析

追踪市场指数表现

1. 获取当前 CMC100 数值：/v3/index/cmc100-latest
2. 获取历史数据：/v3/index/cmc100-historical
3. 对比不同时间段的表现

监控社区活跃度

1. 查看热度上升代币：/v1/community/trending/token
2. 浏览热门话题：/v1/community/trending/topic
3. 阅读置顶社区帖子：/v1/content/posts/top

构建价格图表

1. 获取 OHLCV K 线数据：/v1/k-line/candles
2. 使用 interval 参数指定时间粒度（如 1h、4h、1d）
3. 基于返回的数据绘制 K 线图

货币换算

1. 获取法币 ID 映射：/v1/fiat/map
2. 执行金额换算：/v2/tools/price-conversion

错误处理

错误响应格式

{
  "status": {
    "error_code": 400,
    "error_message": "Invalid value for 'id'"
  }
}

速率限制响应头

通过以下响应头可监控当前用量：

1. X-CMC_PRO_API_KEY_CREDITS_USED — 已消耗积分
2. X-CMC_PRO_API_KEY_CREDITS_REMAINING — 剩余积分
3. X-CMC_PRO_API_KEY_RATE_LIMIT — 每分钟最大请求数限制

响应格式

所有端点均以如下结构返回 JSON 数据：

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

使用提示

1. 在高频调用前，建议先通过 /v1/key/info 端点核查您的套餐限额
2. 全球指标数据每几分钟更新一次，建议缓存使用
3. 恐惧与贪婪指数每日更新一次，无需频繁轮询
4. K 线数据支持多种时间间隔，适用于不同时间维度的图表需求
5. 社区热度数据会在全天内周期性刷新