mcpField
C
cmc-api-market

cmc-api-market

github.com/opencmc数据与数据库75120 次安装5 天前更新
代码仓库

关于 cmc-api-market

CoinMarketCap 市场 API 技能，覆盖加密货币整体指标、情绪、指数、社区内容和图表数据，供市场分析与数据应用使用。还包含货币换算及 API 用量查询。

主要功能

  1. 01全球市值与 BTC 主导率
  2. 02恐惧与贪婪指数及历史值
  3. 03CMC100 和 CMC20 指数数据
  4. 04社区趋势与最新内容
  5. 05OHLCV 蜡烛图和价格序列
  6. 06货币换算及 API 用量查询

适用场景

  1. 01结合市场情绪与全球指标评估行情
  2. 02比较 CMC100 与 CMC20 的历史表现
  3. 03获取 OHLCV 数据绘制价格图表
  4. 04追踪社区热门代币和讨论话题

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/cmc-api-market确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

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

详细介绍

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 市值占比
  4. 跟踪市值历史数据
  5. 跟踪恐惧与贪婪指数历史数据
  6. 获取 CMC100 指数表现
  7. 对比 CMC100 与 CMC20
  8. 获取用于绘制图表的 OHLCV 蜡烛图数据
  9. 获取简单的价格时间序列
  10. 获取社区热门代币
  11. 获取热门讨论话题
  12. 获取最新加密货币新闻
  13. 转换货币金额
  14. 检查 API 用量和限额
  15. 获取法定货币 ID

API 概览

全球指标
端点描述参考文档
GET /v1/global-metrics/quotes/historical全球市场指标历史数据global-metrics.md
GET /v1/global-metrics/quotes/latest最新总市值、BTC 市值占比global-metrics.md
恐惧与贪婪指数
端点描述参考文档
GET /v3/fear-and-greed/historical恐惧／贪婪指数历史值fear-greed.md
GET /v3/fear-and-greed/latest当前市场情绪评分fear-greed.md
市场指数
端点描述参考文档
GET /v3/index/cmc100-historicalCMC100 指数历史数据indices.md
GET /v3/index/cmc100-latestCMC100 指数当前值indices.md
GET /v3/index/cmc20-historicalCMC20 指数历史数据indices.md
GET /v3/index/cmc20-latestCMC20 指数当前值indices.md
社区
端点描述参考文档
GET /v1/community/trending/token根据社区活动确定的热门代币community.md
GET /v1/community/trending/topic热门讨论话题community.md
内容
端点描述参考文档
GET /v1/content/latest最新新闻和 Alexandria 文章content.md
GET /v1/content/posts/comments特定帖子的评论content.md
GET /v1/content/posts/latest最新社区帖子content.md
GET /v1/content/posts/top排名靠前的社区帖子content.md
K 线图
端点描述参考文档
GET /v1/k-line/candlesOHLCV 蜡烛图数据kline.md
GET /v1/k-line/points价格／市值时间序列数据点kline.md
工具
端点描述参考文档
GET /v1/fiat/map将法定货币映射到 CMC IDtools.md
GET /v1/key/infoAPI 密钥用量和套餐详情tools.md
GET /v2/tools/price-conversion在不同货币之间进行转换tools.md

常见工作流

获取市场情绪概览
  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 蜡烛图数据：/v1/k-line/candles
  2. 使用 interval 参数设置时间范围（1h、4h、1d）
  3. 使用返回的数据绘制蜡烛图
货币换算
  1. 获取法定货币 ID：/v1/fiat/map
  2. 换算金额：/v2/tools/price-conversion

错误处理

状态码含义操作
400请求错误检查参数值和格式
401未授权验证 API 密钥是否有效
403禁止访问你的套餐不支持此端点
429请求过多等待后退避重试
500服务器错误延迟后重试
错误响应格式
{
  "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. 社区热门数据在一天内定期刷新

评论

支持 Markdown