CoinGecko 行情数据 API

适用主体

行情看板开发者、市场数据工具开发者、链上数据应用团队、需要合法数据许可的产品团队

接入方式

Demo 使用 x-cg-demo-api-key，并请求 Demo API 域名 / Pro 使用 x-cg-pro-api-key，并请求 Pro API 域名 / 官方建议在服务端保存密钥，优先通过请求头传递

申请概况

注册后可获取 Demo API Key；付费数据、实时能力与商用许可按套餐开放。

• 注册 CoinGecko 用户并在 Developer Dashboard 获取所选套餐的 API Key。
• 将 Demo 与 Pro 的域名和请求头分开配置；密钥保存在服务端，避免写入公开页面、查询 URL 或日志。
• 预估每月 credits 和每分钟限频，核对数据更新速度、历史长度及所需端点是否在套餐内。
• 公开产品需核对署名、商业许可及再分发要求；基础商业许可不自动包含转售数据或白标权。

1. 01

   确定数据与许可需求

   列出资产、时间范围、更新频率及展示或商用方式，再比较 Demo 与付费套餐。

2. 02

   申请密钥并选对域名

   从官方申请入口进入 Developer Dashboard，取得密钥并配置对应 Demo 或 Pro 域名。

3. 03

   先验证少量读取

   按认证文档从连通性或简单价格查询开始，检查错误响应、返回字段和用量。

4. 04

   完善展示与用量控制

   配置缓存、限频及额度告警，并按许可增加数据署名；需要转售或白标时先处理专门授权。

使用范围与限制

• 本条目按 Demo 与 Pro 的 API Key 认证流程介绍公开市场数据接入，不承诺匿名或无限调用。
• CoinGecko 不是账户交易接口，不能据此查询个人交易所余额、下单或提现。
• Demo 与 Pro 密钥及 API 根域名不同，不能混用；可用端点、历史和更新频率亦不同。
• 商业许可仍要求相应署名；标准商业许可不允许转售、转授权或再分发 API 访问，白标或数据再销售通常需要定制许可。
• 数据覆盖、时间延迟及资产历史存在边界，不能将聚合行情当作某个交易所可执行报价。

如何进行开发测试

• Demo 是免费数据套餐，使用 Demo API 根域名及专用密钥；它不是交易所撮合模拟盘。
• Pro 使用独立 API 根域名与付费密钥，按已订阅的数据范围访问。
• 开发阶段可从 Demo 的少量读取验证，仍需遵守 credits、限频和署名规则；本次未实际请求行情接口。

以下资料用于核对本页内容。申请与使用时，请以对应接口的最新规则为准。

1. 01
   CoinGecko API Endpoint Overview：行情、历史、交易所与链上数据已核对官方资料 · 2026-10-15
2. 02
   Demo API Endpoint Overview已核对官方资料 · 2026-10-15
3. 03
   Demo API 认证、域名与成功请求 credits已核对官方资料 · 2026-10-15
4. 04
   Pro API 认证、域名与失败请求限频已核对官方资料 · 2026-10-15
5. 05
   官方价格、Demo 额度、商业许可与再分发边界已核对官方资料 · 2026-10-15