mcpField
C
cmc-api-crypto

cmc-api-crypto

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

关于 cmc-api-crypto

cmc-api-crypto 是使用 CoinMarketCap Cryptocurrency API 的参考技能，帮助开发者通过文档化端点获取当前及历史市场数据、列表、代币元数据和交易信息。

主要功能

  1. 01最新报价与市场列表
  2. 02历史报价和 OHLCV 数据
  3. 03热门币种与新上架列表
  4. 04代币元数据及 CMC ID 查询
  5. 05类别与交易对数据
  6. 06端点和错误参考

适用场景

  1. 01按代币符号查询价格
  2. 02构建历史价格图表
  3. 03查找市值排名靠前的币种
  4. 04查看币种的交易对

安装

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

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

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

包含的文件

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

references/
categories.md
info.md
listings.md
map.md
market-pairs.md
ohlcv.md
price-performance.md
quotes.md
trending.md
use-cases.md

详细介绍

CoinMarketCap 加密货币 API

本技能涵盖 CoinMarketCap 加密货币 API 端点，可用于获取价格数据、市场列表、历史报价、热门币种和代币元数据。

身份验证

所有请求都必须在请求头中提供 API 密钥。

curl -X GET "https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/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. 根据代币符号或名称查找其 CMC ID
  3. 根据合约地址获取代币
  4. 获取市值排名前 100 的币种
  5. 查找价格处于指定范围内的币种
  6. 获取指定日期的历史价格
  7. 构建价格图表（OHLCV 数据）
  8. 查找币种的交易平台
  9. 获取历史最高价及其与 ATH 的差距
  10. 查找今日涨幅最大的币种
  11. 发现新上线的币种
  12. 获取某个类别中的所有代币（例如 DeFi）

API 概览

端点说明参考
GET /v1/cryptocurrency/categories列出所有类别及其市场指标categories.md
GET /v1/cryptocurrency/category单个类别的详情categories.md
GET /v1/cryptocurrency/listings/historical历史列表快照listings.md
GET /v1/cryptocurrency/listings/latest当前列表及市场数据listings.md
GET /v1/cryptocurrency/listings/new新添加的加密货币listings.md
GET /v1/cryptocurrency/map将名称/符号映射到 CMC IDmap.md
GET /v1/cryptocurrency/trending/gainers-losers涨幅和跌幅最大的币种trending.md
GET /v1/cryptocurrency/trending/latest当前热门币种trending.md
GET /v1/cryptocurrency/trending/most-visitedCMC 上访问量最高的币种trending.md
GET /v2/cryptocurrency/info静态元数据（徽标、说明、URL）info.md
GET /v2/cryptocurrency/market-pairs/latest币种的交易对market-pairs.md
GET /v2/cryptocurrency/ohlcv/historical历史 OHLCV 蜡烛图数据ohlcv.md
GET /v2/cryptocurrency/ohlcv/latest最新 OHLCV 数据ohlcv.md
GET /v2/cryptocurrency/price-performance-stats/latest价格表现统计数据price-performance.md
GET /v2/cryptocurrency/quotes/latest最新价格报价quotes.md
GET /v3/cryptocurrency/quotes/historical历史价格报价quotes.md

常见工作流

根据符号获取代币价格
  1. 首先，使用 /v1/cryptocurrency/map 将符号映射到 CMC ID
  2. 然后，使用 /v2/cryptocurrency/quotes/latest 获取价格
# Step 1: Get CMC ID for ETH
curl -X GET "https://pro-api.coinmarketcap.com/v1/cryptocurrency/map?symbol=ETH" \
  -H "X-CMC_PRO_API_KEY: your-api-key"

# Step 2: Get price quote (using id=1027 for ETH)
curl -X GET "https://pro-api.coinmarketcap.com/v2/cryptocurrency/quotes/latest?id=1027" \
  -H "X-CMC_PRO_API_KEY: your-api-key"
获取市值排名前 100 的币种
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"

错误处理

HTTP 状态码
代码含义
200成功
400错误请求（参数无效）
401未授权（API 密钥无效）
403禁止访问（你的套餐不支持此端点）
429超出速率限制
500服务器错误
速率限制

速率限制取决于你的订阅套餐。响应头中包含：

  1. X-CMC_PRO_API_KEY_CREDITS_USED - 本次调用使用的额度
  2. X-CMC_PRO_API_KEY_CREDITS_LEFT - 剩余额度
常见错误

ID 无效：确保使用 /map 端点返回的有效 CMC ID。按符号查询可能会返回多个匹配项。

缺少必需参数：某些端点至少需要一个标识符（id、slug 或 symbol）。

套餐限制：历史数据端点和某些功能需要付费套餐。请查看你的套餐限制。

错误响应格式
{
  "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": { ... }
}

参考文件

有关每个端点的完整参数和响应文档，请参阅 references/ 目录。

评论

支持 Markdown