cmc-api-exchange

CoinMarketCap 交易所 API 技能

此技能涵盖面向中心化加密货币交易所（Binance、Coinbase、Kraken 等）的 CoinMarketCap API。使用这些端点检索交易所元数据、交易量、市场交易对和资产持仓。

身份验证

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

1. 在 https://pro.coinmarketcap.com/login 获取 API 密钥
2. 在所有请求中加入请求头 X-CMC_PRO_API_KEY: your-api-key

curl -X GET "https://pro-api.coinmarketcap.com/v1/exchange/map" \
  -H "X-CMC_PRO_API_KEY: your-api-key"

基础 URL

https://pro-api.coinmarketcap.com

常见用例

请参阅 use-cases.md，根据目标了解该使用哪个端点：

1. 按名称获取交易所信息
2. 查找交易所的 CMC ID
3. 获取按交易量排名的顶级交易所
4. 仅获取现货交易所（或仅获取衍生品交易所）
5. 获取特定交易所的当前交易量
6. 比较多个交易所的交易量
7. 获取交易所的历史交易量
8. 获取交易所上的所有交易对
9. 查找交易所上的 BTC 交易对
10. 获取交易所上的永续合约／期货交易对
11. 检查交易所储备金（储备金证明）
12. 查找上架特定代币的交易所

API 概览

端点	说明	参考
GET /v1/exchange/map	将交易所名称映射到 CMC ID	references/info.md
GET /v1/exchange/info	交易所元数据（徽标、URL、描述）	references/info.md
GET /v1/exchange/listings/latest	列出所有包含市场数据的交易所	references/listings.md
GET /v1/exchange/quotes/latest	最新交易所交易量和指标	references/quotes.md
GET /v1/exchange/quotes/historical	交易所历史交易量数据	references/quotes.md
GET /v1/exchange/market-pairs/latest	交易所上的交易对	references/market-pairs.md
GET /v1/exchange/assets	交易所持有的资产	references/assets.md

常见工作流

获取交易所信息

原因： 大多数端点需要 CMC 交易所 ID，而不是名称。map 端点可将便于人类阅读的 slug 转换为 ID。

1. 调用 /v1/exchange/map，并使用 slug=binance 获取交易所 ID
2. 使用该 ID 调用 /v1/exchange/info，获取完整元数据

比较交易所交易量

原因： 交易量反映流动性和可信度。交易量越高，价格执行效果越好，滑点越低。

1. 调用 /v1/exchange/listings/latest，获取按交易量排名的所有交易所
2. 使用 sort=volume_24h 和 sort_dir=desc 按降序排列

分析交易对

原因： 了解可用交易对有助于用户找到交易特定资产的场所，并比较不同交易平台的流动性。

1. 从 /v1/exchange/map 获取交易所 ID
2. 使用该 ID 调用 /v1/exchange/market-pairs/latest
3. 根据需要按 category=spot 或 category=derivatives 筛选

跟踪交易量历史

原因： 历史交易量能够揭示趋势。交易量下降可能意味着用户流失；交易量激增则可能表明存在刷量交易或新闻事件。

1. 从 /v1/exchange/map 获取交易所 ID
2. 调用 /v1/exchange/quotes/historical 并指定日期范围参数

查询参数

大多数端点都接受以下常见参数：

参数	类型	说明
id	string	CMC 交易所 ID（多个 ID 以逗号分隔）
slug	string	交易所 slug（例如，“binance”）
convert	string	价格换算所用的货币（默认值：USD）
aux	string	要包含在响应中的其他字段

错误处理

所有响应都包含一个 status 对象：

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

常见错误代码

代码	含义
0	成功
400	请求错误（参数无效）
401	未授权（API 密钥无效）
403	禁止访问（超出套餐限制）
429	超出速率限制
500	内部服务器错误

速率限制

速率限制取决于你的订阅计划。请查看响应中的 credit_count，以跟踪 API 积分用量。每个请求都必须包含 X-CMC_PRO_API_KEY 标头。

响应格式

所有响应均以 JSON 格式返回，结构如下：

{
  "status": { },
  "data": { }
}

根据端点不同，data 字段包含对象（单个项目）或数组（多个项目）。