# CoinMarketCap API：核同名币、免密钥入口与错误响应

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/cmc-keyless-id-envelope-quota-record-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

固定CMC ID和接口范围，避免把HTTP成功、symbol命中或权限失败当成完整行情。

## 使用工具
- [CoinMarketCap API](https://lianxiaozhi.com/tools/coinmarketcap-api) · [官方入口](https://coinmarketcap.com/api/documentation)

## 前置条件
- 准备已有脱敏请求、响应或面板记录及读取时间；本教程按公开官方资料整理，未调用业务API、登录、配置密钥或执行资金操作。

## 1. 按任务固定完整路径

免密钥根是https://pro-api.coinmarketcap.com/public-api，只支持官方清单中的GET端点，不发送X-CMC_PRO_API_KEY。认证Pro根不含/public-api，使用该header；记录完整版本与路径。

例如行情quotes与DEX token/pool是不同任务；同一host不表示相同参数或覆盖。不能把所有Pro路径直接加前缀当免密钥接口。

核对结果：任务、根路径、版本和官方支持范围对应。
依据：[CMC免密钥范围](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api.md)
依据：[CMC认证与credits](https://coinmarketcap.com/api/documentation/guides/authentication.md)
依据：[CMC端点选择](https://coinmarketcap.com/api/documentation/pro-api-reference/endpoint-overview.md)

## 2. 用资产ID避免symbol歧义

从cryptocurrency/map核CMC id、名称与slug。官方约定同symbol多命中时默认最高市值资产，名称相同不能证明查到目标。CMC资产ID、CoinGecko ID、合约地址和网络ID不可互换；DEX还须固定对应链与token或pool地址。

核对结果：资产身份有CMC ID或链+完整合约依据，没有凭symbol补身份。
依据：[CMC响应与ID约定](https://coinmarketcap.com/api/documentation/guides/standards-and-conventions.md)
依据：[CMC免密钥范围](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api.md)

## 3. 核HTTP与JSON两层结果

读取实际HTTP状态，以及status.error_code、error_message和data。保留原字段类型和响应形状，不假定每个版本data都为数组：旧版bundling可能返回对象映射。

HTTP成功不替代业务状态与所需资产检查；空data、资产缺项、无法解析、非零错误码分别记录。status.timestamp是服务器执行时点，不自动是每个价格的采样时点。

核对结果：HTTP、业务错误、数据形状及资产缺项分列。
依据：[CMC响应与ID约定](https://coinmarketcap.com/api/documentation/guides/standards-and-conventions.md)
依据：[CMC错误码与限流](https://coinmarketcap.com/api/documentation/guides/errors-and-rate-limits.md)

## 4. 把限流与套餐错误分开

认证入口429需区分1008分钟、1009每日、1010每月和1011 IP限流；403的1005/1006/1007分别涉及需key、套餐不支持和key禁用。免密钥共享IP池没有在本页给统一数值。

等待一分钟不能解决月额度或权限问题。保留原错误，不反复改路径重试或把失败页计成零行情。

核对结果：错误码、入口和限制层级有依据，未取得数据保持未知。
依据：[CMC错误码与限流](https://coinmarketcap.com/api/documentation/guides/errors-and-rate-limits.md)
依据：[CMC免密钥范围](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api.md)

## 5. 保存时间与用量范围

保留convert、实际资产/池范围、响应时间及可见数据时间；UTC时间与本地日期分开。认证调用的status.credit_count是实际用量线索，不能用请求数量代替credits。

没有完整分页、正确资产或原响应时，只交付已有覆盖范围，不声称全量数据。本文未执行查询、MCP连接或x402付款。

核对结果：身份、时间、用量和待核范围可复查。
依据：[CMC响应与ID约定](https://coinmarketcap.com/api/documentation/guides/standards-and-conventions.md)
依据：[CMC认证与credits](https://coinmarketcap.com/api/documentation/guides/authentication.md)

## 常见错误
- Symbol默认最高市值匹配不等于用户目标资产。
- 免密钥、Pro、MCP和x402的认证/费用边界不同。

## 完成检查
- 形成入口、身份、两层状态、时点和实际覆盖记录。

## 相关知识

## 官方依据
- [CMC免密钥范围](https://coinmarketcap.com/api/documentation/pro-api-reference/keyless-public-api.md)
- [CMC认证与credits](https://coinmarketcap.com/api/documentation/guides/authentication.md)
- [CMC端点选择](https://coinmarketcap.com/api/documentation/pro-api-reference/endpoint-overview.md)
- [CMC响应与ID约定](https://coinmarketcap.com/api/documentation/guides/standards-and-conventions.md)
- [CMC错误码与限流](https://coinmarketcap.com/api/documentation/guides/errors-and-rate-limits.md)