无需API密钥，如何测试CoinMarketCap接口

领域OK报道：

欧易(OKX)

全球三大交易所之一，注册领50U数币盲盒，币圈常用的交易平台！

立即注冊立即下载

币安(Binance)

币安是世界领先的数字货币交易平台，注册领100U。

立即注冊立即下载

引言

在注册账户之前，你可以使用无密钥的CoinMarketCap API直接对真实生产数据进行测试，无需注册，无需密钥。试用版专业API与经过认证的API使用相同的生产环境，返回实时数据，因此你可以在编写实际集成代码之前，确认响应格式和端点行为是否符合你的项目需求。

本指南将介绍如何发起无密钥请求、响应格式、可用的端点，以及如何在你准备好后迁移到正式密钥。

什么是无密钥API

CoinMarketCap无密钥公共API允许你在没有账户、无需注册、无需X-CMC_PRO_API_KEY头的情况下，调用精心挑选的生产端点子集。基础URL为：

https://pro-api.coinmarketcap.com/trial-pro-api

你只需附加与认证API相同的端点路径，但不带任何密钥头。该API旨在用于原型开发和评估，在创建账户之前测试API是否满足你的用例。

无密钥API可用的内容

无密钥公共API覆盖35个以上的实时生产端点。根据当前文档，子集包括：

标准API（19个端点）

加密货币列表（最新、新增）

加密货币报价（最新）

全球指标（最新）

恐惧与贪婪指数（最新和历史）

CMC指数（CMC100、CMC20，最新和历史）

山寨币季节指数（最新和历史）

加密货币地图和信息

DEX API（17个端点）

DEX代币详情和价格

DEX池

DEX交易对报价

持有者（数量、列表、详情）

K线蜡烛图

代币搜索

发起无密钥请求

与认证请求的唯一区别在于URL前缀和缺少密钥头。

cURL

curl -G ‘https://pro-api.coinmarketcap.com/trial-pro-api/v1/cryptocurrency/listings/latest’ \

–data-urlencode ‘limit=10’ \

–data-urlencode ‘convert=USD’ \

-H ‘Accept: application/json’

无需任何头。立即返回真实的排名市场数据。

Python

import requests

response = requests.get(

    “https://pro-api.coinmarketcap.com/trial-pro-api/v1/cryptocurrency/listings/latest”,

    headers={“Accept”: “application/json”},

    params={“limit”: “10”, “convert”: “USD”},

)

response.raise_for_status()

data = response.json()

print(data)

Node.js

const response = await fetch(“https://pro-api.coinmarketcap.com/trial-pro-api/v1/cryptocurrency/listings/latest”, {

  headers: {“Accept”: “application/json”}

});

const data = await response.json();

console.log(data);

响应格式完全相同

无密钥API返回与认证API相同的JSON封装结构。相同的数据和状态结构，相同的字段名，相同的ID系统。针对无密钥响应编写的解析代码在切换到认证访问后无需修改即可工作。

{

“data”: [

{

“id”: 1,

“name”: “Bitcoin”,

“symbol”: “BTC”,

“cmc_rank”: 1,

“quote”: {

“USD”: {

“price”: 63120.95,

“market_cap”: 1265258535378.41,

“volume_24h”: 29127614493.57,

“percent_change_24h”: -1.19

}

}

}

],

“status”: {

“timestamp”: “2026-07-03T10:00:00.000Z”,

“error_code”: 0,

“error_message”: null,

“elapsed”: 12,

“credit_count”: 1

}

}

这就是无密钥API的核心优势：你针对它学习和构建的所有内容都可以直接迁移到生产环境。

迁移到认证访问

当你准备好使用更高的速率限制和完整的端点目录时，迁移只需更改一行。

无密钥请求：

GET https://pro-api.coinmarketcap.com/trial-pro-api/v1/cryptocurrency/listings/latest

认证请求：

GET https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/latest

X-CMC_PRO_API_KEY: YOUR_API_KEY

从URL中移除/trial-pro-api，添加X-CMC_PRO_API_KEY头。其他一切保持不变。

获取免费API密钥，免费基础计划包含15000个月度积分和30+端点访问。

无密钥API的限制

无密钥API专为原型开发和评估设计，不适用于生产环境。

严格速率限制。在有任何实际负载的情况下，你会很快达到限制。在正式上线前请迁移到认证计划。

固定端点子集。不在精选集合内的端点会返回错误。如果你需要未覆盖的端点，则需要密钥。

不可用于商业用途。无密钥API是评估工具。生产工作负载需要认证计划。