构建、分析和扩展 使用加密货币最值得信赖的数据API


体验我们的实时 API 数据
选择代币和日期
选择代币、NFTs 或类别
/coins/bitcoin/history?date={DD-MM-YYYY}
{
"id": "bitcoin",
"symbol": "btc",
"name": "比特币",
"image": {
"thumb": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400"
},
"market_data": {
"current_price": {
"usd": 75266.76731147344,
...
},
"market_cap": {
"usd": 1513618905572.7002,
...
},
"total_volume": {
"usd": 30810479654.069714,
...
}
}
}
curl -X GET "https://api.coingecko.com/api/v3/coins/bitcoin/history?date=10-11-2026" \ -H "accept: application/json"
为任何应用程序和工作流 通过一个涵盖加密、链上和代币化市场的 API 提供动力
交易平台与钱包
利用实时多链跟踪和已验证的资产元数据,构建无缝交易和托管界面。
人工智能体和 DeFAI
用实时数据为自主智能体提供动力,以消除价格幻觉,并提供准确的市场趋势洞察分析
分析工具
使用宏观生态系统洞察分析和专业化机构资金库数据,创建专业级市场跟踪器。
机构交易
为专业基础设施提供支持,用于全球套利的高分辨率历史数据和统一的流动性监测。
去中心化金融和 Web3 的应用程序
借助抗操纵价格信息和实时健康指标,维护链上资产的协议。
审计和合规
全自动报告使用经过核实的历史档案,生成符合审计要求的截图和精确的持有成本计算。
一个 API 搞定整个数字资产市场。 通过单一 API 访问实时和历史加密价格、链上数据以及代币化资产。
加密货币与代币
/coins/*
列出 CoinGecko 上所列货币和代币的实时与历史价格、市场数据和元数据,包括图片、描述、链接、社交统计数据和供应信息。
现实世界资产(RWA)
/rwas/*
获取代币化股票、大宗商品和 ETF 的市场数据,包括底层代币、发行方、交易场所和历史数据。
交易所
/exchanges/*
获取 CoinGecko 上中心化现货交易所的数据,包括行情、交易量和交易所元数据。
金融衍生品
/derivatives/*
获取 CoinGecko 上中心化衍生物交易所的数据,包括行情、交易量和交易所元数据。
链上去中心化交易所
/onchain/*
列出 GeckoTerminal 上所列区块链池与代币的实时与历史数据,包括价格、市值、交易量与流动性。
链上交易
/onchain/.../trades/*
从链上池和代币中获取或流式传输交易,包括交易哈希值、钱包地址、交易方向、交易规模和价值。
历史走势图
/coins/.../market_chart/*
获取长达 13 年的历史加密市场数据和价格走势图,细粒度精确到每 5 分钟。
柱线图 和 柱线体积图 图表
/ohlc/*
/ohlcv/*
用实时与历史性 OHLCV(开盘价、最高价、最低价、收盘价、成交量)数据,构建精准度高达亚秒的图表。
搜尋
/search/*
按名称、代码或合约地址在 CoinGecko 上搜索代币、类别和交易所,或在 GeckoTerminal 上搜索池和代币。
发现
/onchain/.../new_pools
/onchain/pools/megafilter
通过高级筛选获取 CoinGecko 上最新上架的代币,以及 GeckoTerminal 上最新上架的池和代币。
货币类别
/categories/*
列于 CoinGecko 与 GeckoTerminal 上货币与代币的所有类别,以及按类划分的市场数据。
公开储备
/public_treasury/*
列出上市公司及政府的加密资产储备数据,涵盖 BTC、ETH 及其他各类数字资产储备 (DAT) 及它们的现值。
NFT
/nfts/*
列于 CoinGecko 上不可替换代币藏品的实时与历史数据,包括底价、市场数据和和元数据。
热门
/onchain/.../trending_pools
/search/trending
获取 CoinGecko 上的热门代币,以及 GeckoTerminal 上的热门池。
链上持有人
/onchain/.../top_holders
获取 GeckoTerminal 上代币的顶级代币持有人和历史持币人趋势。
链上钱包
/onchain/wallets/*
获取任何钱包地址的代币余额、交易、PnL 和原始代币转账,以及跨多个网络的每项持仓的 USD 价值和流动性。
全球
/global/*
列出全球加密货币市场的数据,比如随时间变化的总市值、交易量和市场占有率。
获取全面、高保真度的报道
覆盖所有主流网络的最广泛资产支持
覆盖 CEX 和 DEX 上超过 3600 万个交易对
值得信赖的可靠基础设施
支持所有主要的区块链,如以太坊、比特币、Solana 等
具有秒级粒度的广泛历史数据
可信数据 覆盖加密与代币化市场
严格的检查和算法确保所有代币信息准确、可信赖,且不存在操纵、诈骗或不良数据,为开发者和企业提供用于关键任务应用程序的可靠来源。
我们从各种中心化交易所和去中心化交易所收集数据,用我们专有的比特币价格指数(BPI)作为参考基准,然后在滤除异常值后,汇总各货币的市场价格。
为开发者、vibe coders、研究人员提供的,几乎涉及所有人无缝体验
企业级 受到全球领先的加密与金融应用程序的信赖 的业绩
基于企业级安全性进行构建
CoinGecko API 符合 SOC 2 Type 2 标准,并经过独立审计。
我们的系统和流程符合严格的行业标准,以保障数据安全。我们致力于保持最高水平的信任度和透明度,让您安心构建。
从辅助项目到行业巨头
@coingecko is definitely the best – A Thread 🧵
If you wanna develop something cool in crypto, the CoinGecko API is a must-try! It's packed with information on almost every coin and token, plus chain data. And it's super easy to integrate.
有问题?
-
CoinGecko API是免费的吗?
- CoinGecko API 提供免费及付费计划。所有 CoinGecko 用户都可以免费使用 API 演示计划,它的稳定调用频率为每分钟 100 次,每月的调用上限是 10,000 次。付费计划的起价为每月 35 美元,能提供每分钟 300 次的较高调用频率,和每月 100,000 次的调用上限。
-
什么是CoinGecko API?
-
CoinGecko API 是一个全面且深受行业信赖的加密数据 API,涵盖中心化、链上和代币化市场。它通过一个统一、可扩展的 API,让开发者、项目和企业能够获取涵盖加密资产、去中心化交易所、代币化股票、大宗商品和其他现实世界资产的可靠市场数据。
CoinGecko API 的独特之处在于其独立性和数据准确性方面的良好声誉。与交易所旗下的数据提供商不同,CoinGecko 的动力来源于数据准确性,而非交易量。我们的加密资产均经过独立验证,并使用我们的 公布的方法 汇总了中心化和去中心化交易所的价格。
CoinGecko API 被广泛公认为行业内最值得信赖的代币合规性与市场数据来源,拥有业内顶尖的市场及链上去中心化交易所覆盖率。 -
CoinGecko API 的速率限制是多少?
- CoinGecko API 演示计划的调用频率为每分钟 100 次,而付费计划的调用频率更高,为每分钟 300 至 2,500 次。如果您有意探索定制计划,及其灵活的调用频率、专职的账户管理、全面的咨询服务和战略数据的顾问分析,请联系我们的 企业销售团队。
-
可以通过CoinGecko API获取实时和历史加密货币价格吗?
-
是的。CoinGecko API 提供涵盖加密货币和代币化资产的实时及历史市场数据。对于加密货币,您可以使用 /simple/price 和 /coins/markets 等 endpoint,或者通过 CoinGecko 的 WebSocket API 传输低延迟价格更新。
可以通过 /coins/{id}/market_chart 和 /coins/{id}/history 等 endpoint 获取历史加密数据,提供长达 13+ 年的价格、市值和成交量数据(受数据可用性和您的 API 订阅计划约束)。
对于代币化现实世界资产,专属 RWA 端点 提供实时市场数据,而付费计划则可解锁历史价格、市值和成交量数据,用于更深入的分析和回测。 -
CoinGecko API 是否提供现实世界资产(RWA)和代币化资产数据?
- 是的。CoinGecko API 提供代币化现实世界资产的市场数据,包括代币化股票、大宗商品和其他 RWA。您可以了解支持的资产,获取价格、市值和交易量数据,比较底层代币和发行方,查找跨中心化交易所和去中心化交易所的交易市场,并可以通过 专属 RWA 端点 检索历史市场数据。
-
我可以通过CoinGecko API访问链上去中心化交易所数据吗?
-
是的!您可以通过 CoinGecko API 上的 20 多个 endpoint 访问 链上去中心化交易所数据。关键数据集包括加密货币流动性池、按合约地址分类的代币数据和 OHLCV 走势图数据。
此数据由我们的姐妹产品 GeckoTerminal 提供支持,它负责监控 360+ 个区块链网络上 2,000+ 家交易所的实时加密货币价格、成交量、交易明细、流动性等——包括 Uniswap、PancakeSwap、Orca、Curve 和 Balancer 等热门平台。 -
CoinGecko API提供的链上数据有哪些例子?
-
CoinGecko API 能为多于 50M 种代币提供丰富的链上市场数据,涵盖包括以太坊、Solana、TON、BNB Chain 和 Base 在内的至少 360 个区块链网络,一些常用的链上数据类型包括:
-
CoinGecko API 是否适用于企业级业务?
-
绝对可以。CoinGecko API 经过了大规模的实战检验,并赢得了业内一些知名机构的信任,包括 Consensys、Chainlink、Coinbase、Ledger、Etherscan 等。请查看我们的 案例研究,了解他们是如何使用 CoinGecko API 的。
我们的 Enterprise 计划提供:- 专属数据访问 — 企业专用 endpoint,包括历史流通供给量和总供应量数据,以及完整访问 13+ 年全分辨率历史数据的权限
- 专属支持与客户管理 — 24/7 私人 Slack 和电子邮件支持、可定制的 SLA 以及专职客户成功经理
- 长期数据合作伙伴: CoinGecko 不仅是数据提供商;我们更是可以与您共同构建的合作伙伴,通过集成咨询、业务复盘和协作式路线图规划来支持您的业务增长
- 灵活的按用量计费计划 — 根据您的需求定制速率限制、积分、API 密钥、白标选项和 数据许可
- 任务关键型可靠性 — 99.9% 正常运行时间 SLA,配合全天候企业级监控
如果您意在规模化构建,我们已准备好与您一同成长。
📩 联系我们的团队,探讨企业级合作事宜。
-
商业授权与自定义授权有何区别?
-
Basic、Analyst、Lite、Pro 和 Pro+ 计划的商业用途:
- 您的产品应在显著位置标明“由 CoinGecko 提供数据”,并包含指向 https://www.coingecko.com/en/api 的超链接。了解关于我们品牌指南的更多信息 此处。
- 您有权为包含或整合 CoinGecko API 数据的服务和产品收费。但是,您无权出售、出租、租赁、二次许可、再分配或联合分发 CoinGecko API 或其任何部分的使用权。了解关于我们 API 条款的更多信息 此处。
请在此联系我们的团队,以便就您的特定需求获得建议。 -
我是否可以根据自己的需求来制定订阅方案?
- 如果您不确定目前的订阅等级是否符合您的需求,请通过 此处 与我们联络,或许我们可以根据您的预算为您量身打造适合您的企业方案。
-
我有哪些付款方式?
-
信用卡支付(Visa、Mastercard、American Express、Discover 和 JCB)是 Basic、Analyst、Lite、Pro 和 Pro+ 计划的默认付款方式。
Analyst 计划及以上版本的年度订阅也支持加密货币支付。您可以直接在结账页面选择此选项。
至于 Enterprise 计划,请联系我们 此处,我们的团队可以更好地向您介绍美元银行转账等付款选项。 -
加密货币支付的局限性是什么?
-
加密货币支付的局限性如下:
- 仅限于年度订阅
- 续订付款需手动操作 — 在订购到期前 14 天和 7 天,您将收到续订提醒 无法启用
- 超额功能 不直接支持
- 计划的升级和降级 — 您只能取消。如果您想更改您的计划,您需要先取消,然后再次订购您想要的计划类型。
- 不能退款
-
超出限额时是如何收费?
- 每调用500,000次收取250美元。
-
CoinGecko API是如何计算API使用积分的?
- 1次调用 = 1个积分。呼叫任意端点都只算为1次调用。
-
我的调用次数(每月API额度) 何时重置?
-
无论您的计费周期为何,您的调用次数从当月的第一天开始计算至最后一天为止。
如果您在当月第一天之后的某日开始订阅,您仍将在该月所剩天数中获得完整的调用额度。然后,在下一个月的第一天,您的调用额度将再度重置。 -
CoinGecko API 订阅的退款政策是什么?
- 所有付款必须在使用计划的开始日期前支付,并在每个循环计费周期后进行付款(无论是整体还是部分支付),均不可退款。
-
示范版、基础版、分析版、精简版、专业版、专业加强版和企业版计划之间的区别是什么?
-
- Demo 计划是试用 CoinGecko API 的免费计划。它适合测试和探索,但包含有限的调用积分,且频率限制为 100 次调用/分钟。
- Basic 计划适合需要更多调用积分、更高频率限制和更频繁数据更新的个人使用。
- 同时,Analyst、Lite、Pro 和 Pro+ 计划专为更严谨的分析工作和中小型项目而设计。它们包含更完整的 CoinGecko API 功能套件,包括实时数据、90+ 个 endpoint 和商业许可。它们之间的主要区别在于调用积分和频率限制。
- 对于高使用量且需要定制计划以满足其业务需求(包括定制许可、SLA、战略咨询等)的企业,Enterprise 计划将是最佳选择。
-
我对付费方案有兴趣。付费方案有没有提供购买前的试用服务?
- 针对企业计划,我们可为有意转换计划的用户提供最多2周的试用服务(视个别情况而定)。请通过 此处 与我们联系,我们会尽快与您联络。请注意,我们的试用计划并不支持超额收费功能。
-
我的订阅何时到期?
- 采用月订阅方案的使用者,其单月的订阅期间会在启用日起算满一个月之日到期。至于年订阅制,其单年订阅方案会在购买后365天内到期。请注意,系统会预设开启自动续订以确保我们为使用者提供的订阅服务不中断。
-
我是否能在下一期使用此前未用过的请求数?
- 我们暂时不提供将未使用的请求累计到下一个月使用之类的功能。在您的订阅更新时,请求数就会重置。
-
我希望取消我的订阅。我该如何操作?
-
如果您想取消订阅,仅需前往 开发者面板 并点击绿色分页中的“API方案详情”。
如果您在开发者仪表板上没有看到该选项,请前往 此处 与我们的团队联络并发起取消流程。 -
您是否提供 SLA?
- 是的,我们为企业客户提供SLA。 请前往 此处 联系我们,了解更多信息。
-
我可以在哪里找到我的API密钥?
- 您的API密钥仅会在您于开发人员设定画面中生成该API密钥时显示。请注意,如果该API密钥被泄露,您必须删除这个密钥并重新生成新的密钥。
-
在发起请求时,我应该在哪里输入专业版的API密钥(任何付费计划)?
-
您可以通过下列两种方式来提供您的API密钥:
1. 页首: x-cg-pro-api-key
2. 查询字串参数: x_cg_pro_api_key
注意: API密钥目前仅供CoinGecko API付费计划订户使用,所有API密钥请求应定向至此域名https://pro-api.coingecko.com。建议您将API密钥安全地储存在您自己的后端,并利用代理主机将密钥插入需要的网址中。 -
数据多久会刷新或更新一次?
-
这要看具体情况 - 但端点都被缓存到1至5分钟左右,除非另有规定,否则大部分数据都会按照类似的时间间隔进行更新。Pro API(付费计划)的更新频率通常更快,如简单/价格端点为30秒。
这也意味着,作为用户,您应该尝试限制响应,确保您不会因为调用太频繁而浪费带宽。 -
我可以通过 WebSocket 传输实时数据吗?
-
是的,CoinGecko WebSocket 提供两种主要类型的实时数据流:
- 全局聚合市场价格 - 与仅从单个场所传输未验证原始 Tick 的单交易所数据源不同,我们的聚合定价引擎能够持续引入来自 2,000+ 家全球交易所的实时交易数据。它可以在运行过程中即时进行标准化、按交易量加权并过滤异常 Tick,从而提供机构级别的全球市场价格表现。
- 链上去中心化交易所数据 - 通过 GeckoTerminal 传输链上落定的去中心化交易所池交易和代币价格变动的实时数据流,提供对去中心化交易所流动性和交易事件的即时可见性。
请参阅我们的 API 文档,了解不同 WebSocket 频道的具体更新频率。 -
历史数据最远可以追溯到何时?
-
您可以使用我们的 API 访问自 2013 年以来超过 13 年的历史数据。
这受可用性影响,因为如果某加密货币在开始交易时未受到交易所支持,则其可能不具备全套数据点。 -
什么是历史数据可用性和粒度?
- 所有计划都包括每日和每小时历史数据的访问权限(所能访问的年数取决于您的订购计划)。 如需更高分辨率,企业计划独家提供5分钟和1分钟的时间周期。
-
我可以在哪里找到特定链(例如Arbitrum)的代币清单?
-
您必须使用该资产平台端点来确认您所寻找之区块链的ID。找出ID后,请以正确的ID取代 https://tokens.coingecko.com/<ID>/all.json 这个连结中的ID
在这个例子,网址就会变成 https://tokens.coingecko.com/arbitrum-one/all.json
-
支持团队回应速度有多快?
- 鉴于平时的查询请求数量庞大,我们的支持团队会在48小时内与您联络。
-
这里没有列出我想问的问题,我该到哪里寻求帮助?
- 请访问我们的 帮助中心 查看完整问题列表。您也可以通过 support.coingecko.com 给我们留言。
-
有没有调用消耗提醒功能?
- 是的! 请移到开发者显示屏,点击“通知”标签即可启用用量警示。请注意,一旦用量达到 80% 和 100% 的分界值,用户就会收到电子邮件提醒。您还可以选择在50% 和90% 的信用额度使用时启用额外提示。
-
我的消耗量已达每月可调用量的100%。我该怎么办?
-
您有责任审查和监控计划的使用限制,通过跟踪您的每月配额使用情况,以防止超额使用。您可以通过开发者控制面板追踪API调用次数以获取最新的使用统计信息。
一旦您达到了100%的每月调用量,我们将为您的账户增加更多的请求。超额使用将作为额外费用列入下个月的账单。
如果您的使用量增加,欢迎随时与我们的团队联系,讨论升级到更高级别计划的选项,以满足您的需求。 -
我能不能关掉超额收费功能?
- 是的。默认开启超额计费选项。然而,拥有付费订阅计划的用户可以通过开发者控制面板禁用超额选项。
-
有没有端点可供检查当月/每分钟已使用的调用次数?
- 是的,您可以使用我们的 /密钥端点 来查询您的月度呼叫信用余额和详细信息。
-
如何区分我收到的状态代码?它们各自代表什么涵意?
-
伺服器会在收到请求时发出状态代码来回应使用者的请求。请参考下表以便进一步了解用以表示API调用成功或失败的状态代码。
状态代码说明400(错误请求)这是因为该使用者送出的是无效的请求且伺服器无法处理该项请求。401(未经授权)这是因为该使用者送出的是无效的请求且伺服器无法处理该项请求。429(太多请求)这可能代表使用者已达到调用频率限制。使用者应减少调用次数,或考虑将其服务方案升级,以便享有更寛的调用限制和调用额度。
若想升级您的方案,请参阅“方案”标签的说明。500(内部服务器出错)这是一个通用的错误回应,表示伺服器遭遇意外问题而无法完成该项请求。503(服务不可用)该服务目前不可用。请在 https://status.coingecko.com/ 上检查API状态和更新。10002(缺少API密钥)您提供的API密钥凭证不正确。请在开发者界面中检查您的密钥,并确保您的请求是 已授权。10005您可能无法访问此端点。例如,“此请求限于APIPro版本订阅者”。您可能想要订阅付费计划 此处。1020(拒绝访问)这是由于违反了CDN防火墙规则。CORS错误当服务器没有返回所需的CORS标头时,就会发生CORS错误。您可以了解更多信息,并尝试推荐的解决方案 此处。
数据层 适用于领先的加密与金融应用程序