构建、分析和扩展 使用加密货币最值得信赖的数据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": 80800.83208028424,
...
},
"market_cap": {
"usd": 1624462348578.8765,
...
},
"total_volume": {
"usd": 24190746457.23363,
...
}
}
}
curl -X GET "https://api.coingecko.com/api/v3/coins/bitcoin/history?date=28-10-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/*
列出长达 12 年历史的加密货币市场数据与价格图表,每 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 等端点,或者通过 CoinGecko 的 WebSocket API 传输低延迟价格更新。
可以通过 /coins/{id}/market_chart 和 /coins/{id}/history 等端点获取历史加密数据,提供长达 12 年以上的价格、市值和交易量数据(受数据可用性和您的 API 订阅计划约束)。
对于代币化现实世界资产,专属 RWA 端点 提供实时市场数据,而付费计划则可解锁历史价格、市值和交易量数据,用于更深入的分析和回测。 -
CoinGecko API 是否提供现实世界资产(RWA)和代币化资产数据?
- 是的。CoinGecko API 提供代币化现实世界资产的市场数据,包括代币化股票、大宗商品和其他 RWA。您可以了解支持的资产,获取价格、市值和交易量数据,比较底层代币和发行方,查找跨中心化交易所和去中心化交易所的交易市场,并可以通过 专属 RWA 端点 检索历史市场数据。
-
我可以通过CoinGecko API访问链上去中心化交易所数据吗?
-
是的!通过 CoinGecko API 的 20 多个端点,您可以使用 链上去中心化交易所数据。关键数据库包括加密货币流动矿池、按合约地址排列的代币数据和开高低收量走势图数据。
数据是由我们的相关产品 GeckoTerminal 提供的,它监测包括 Uniswap, PancakeSwap, Orca, Curve 和 Balancer等流行平台在内的200个区块链网络,和它们的100家去中心化交易所,收集实时加密货币价格,交易总额,交易明细,流动性等。 -
CoinGecko API提供的链上数据有哪些例子?
-
CoinGecko API 能为多于 49M 种代币提供丰富的链上市场数据,涵盖包括以太坊、Solana、TON、BNB Chain 和 Base 在内的至少 360 个区块链网络,一些常用的链上数据类型包括:
-
CoinGecko API 是否适用于企业级业务?
-
绝对可以. 业内的一些知名机构,比如Consensys, Chainlink, Coinbase, Ledger, Etherscan 等,实战测试了 CoinGecko API 的扩展性的可靠性。请查看我们的 案例研究 来了解他们是如何使用 CoinGecko API 的。
我们的 企业级计划 提供:- E 专属的数据 — 企业专用端点,包括历史通行和全部数据供应,以及至少 12 年的全层次的历史数据。
- 专业支持与账户管理—全天候专属 Slack 和电子邮件支持、自定义的服务协议 (SLA),以及专职客户成功经理
- 长期数据合作伙伴: CoinGecko 不仅是数据供应商,我们是共同努力的合作伙伴,通过全面咨询、业务评估和制定发展规划,助您增长业务。
- 灵活适应用量的计划 — 自定义速率限制、信用、API 密钥、白标产品和 数据许可 根据您的需要
- 事关成败的可靠性 — 全天候的企业级监控 以保证99.9% 运行的服务协议(SLA)
如果你意在扩展,我们随时愿意与您共同增长。
📩 联系 联系我们的团队,探讨企业级合作事宜。
-
商业授权与自定义授权有何区别?
-
基本版、分析版、精简版和专业版计划的商业用途:
- 您的产品上应在显著位置标明“由 CoinGecko 提供数据”,并有指向 https://cgecko-proxy.deepspace.workers.dev/en/api 的链接,更多了解我们的品牌指南此处
- 您有权为使用或整合 CoinGecko API 数据的服务和产品收费。 但是,您无权出售、出租、租赁、转让、再分配或组合 CoinGecko API 或其中任意部分的使用权。更多了解我们 API 的使用条款此处。
联系我们的团队以提出您的特殊要求。 -
我是否可以根据自己的需求来制定订阅方案?
- 如果您不确定目前的订阅等级是否符合您的需求,请通过 此处 与我们联络,或许我们可以根据您的预算为您量身打造适合您的企业方案。
-
我有哪些付款方式?
-
信用卡支付(Visa、万事达卡、美国运通、Discover 和 JCB)是基本版、分析版、精简版和专业版的默认付款方式。
分析版及更高级版本的年订购计划也可以用加密货币支付。您可在结账页面直接选择此选项。
至于企业计划,请直接联系我们此处,我们的团队可以更好地向您介绍美元银行转账等付款选项。 -
加密货币支付的局限性是什么?
-
加密货币支付的局限性如下:
- 仅限于年度订阅
- 续订付款需手动操作 — 在订购到期前 14 天和 7 天,您将收到续订提醒 无法启用
- 超额功能 不直接支持
- 计划的升级和降级 — 您只能取消。如果您想更改您的计划,您需要先取消,然后再次订购您想要的计划类型。
- 不能退款
-
超出限额时是如何收费?
- 每调用500,000次收取250美元。
-
CoinGecko API是如何计算API使用积分的?
- 1次调用 = 1个积分。呼叫任意端点都只算为1次调用。
-
我的调用次数(每月API额度) 何时重置?
-
无论您的计费周期为何,您的调用次数从当月的第一天开始计算至最后一天为止。
如果您在当月第一天之后的某日开始订阅,您仍将在该月所剩天数中获得完整的调用额度。然后,在下一个月的第一天,您的调用额度将再度重置。 -
CoinGecko API 订阅的退款政策是什么?
- 所有付款必须在使用计划的开始日期前支付,并在每个循环计费周期后进行付款(无论是整体还是部分支付),均不可退款。
-
示范版、基础版、分析版、精简版、专业版、专业加强版和企业版计划之间的区别是什么?
-
- 演示计划是试用 CoinGecko API 的免费计划。它适合试用和探索,但可调用次数有限,调用频率限制为每分钟 100 次。
- 基本计划适于个人使用,有更大的调用额度、更高的频率限制和更频繁的数据更新。
- 同时,分析版、精简版、专业版和专业加强版计划是为更严谨的分析工作和中小型项目设计的。它们具有更完整的 CoinGecko API 功能,包括实时数据、70多个端点和一个商业许可证。不同计划之间的主要区别在于调用额度和频率限制。
- 对于有特定业务需求(包括特定执照许可、服务级别协议、战略咨询等)的高用量企业客户,企业版计划将是最佳选择。
-
我对付费方案有兴趣。付费方案有没有提供购买前的试用服务?
- 针对企业计划,我们可为有意转换计划的用户提供最多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秒。
这也意味着,作为用户,您应该尝试限制响应,确保您不会因为调用太频繁而浪费带宽。 -
Can I stream real-time data via WebSocket?
-
Yes, CoinGecko WebSockets serve two primary types of real-time data streams:
- Aggregated Global Market Pricing - Unlike single-exchange feeds that stream unverified raw ticks from a single venue, our aggregated pricing engine continuously ingests live trading data from 2,000+ global exchanges. It instantaneously normalizes, volume-weights, and filters bad ticks on the fly to deliver an institutional-grade global representation of market prices.
- Onchain DEX Data - Delivers direct streams of DEX pool transactions and token price movements as they land onchain via GeckoTerminal, providing immediate visibility into DEX liquidity and trading events.
Please refer to our API documentation for specific update frequencies across different WebSocket channels. -
历史数据最远可以追溯到何时?
-
您可以使用我们的API存取自2014年以来超过10年的历史数据。
由于某些加密货币可能在交易起始时未受交易平台支持,因而不具有完整的数据点,故此根据其可用性而定。 -
什么是历史数据可用性和粒度?
- 所有计划都包括每日和每小时历史数据的访问权限(所能访问的年数取决于您的订购计划)。 如需更高分辨率,企业计划独家提供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错误。您可以了解更多信息,并尝试推荐的解决方案 此处。
数据层 适用于领先的加密与金融应用程序