建立、分析和擴充 使用加密貨幣最受信賴的資料 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
交易平台和錢包
利用即時多鏈追蹤和驗證資產元資料,建立無縫交易和託管界面。
AI 代理程式與 DeFAI
利用即時數據驅動自主代理程式,消除價格幻影並提供準確的市場趨勢洞察
分析工具
利用宏觀生態系統深入解析和專業機構財資資料,建立專業級市場追蹤器。
機構交易
為專業基礎架構提供支持,提供高解析度歷史資料和統一流動性監控,用於全球套利。
DeFi 與 Web3 應用程式
利用防操縱價格饋送和鏈上資產的即時健康指標,保護您的協議。
稽核與合規
利用經過驗證的歷史檔案,自動生成報告,以產生可供稽核的快照,並進行精確的成本基準計算。
單一 API 滿足整個數位資產市場的需求。 透過單一 API 存取即時與歷史加密貨幣價格、鏈上資料以及代幣化資產。
貨幣和代幣
/coins/*
取得 CoinGecko 上架的貨幣和代幣的即時和歷史價格、市場資料及後設資料,包括圖像、說明、連結、社群媒體統計資料和供應資訊。
現實世界資產 (RWAs)
/rwas/*
取得代幣化股票、大宗商品與 ETF 的市場資料,包含標的代幣、發行方、交易場所與歷史資料。
交易平台
/exchanges/*
取得 CoinGecko 上中心化現貨市場交易平台的資料,包含報價、成交量與交易平台元數據。
衍生性商品
/derivatives/*
取得 CoinGecko 上中心化衍生性商品交易平台的資料,包含報價、成交量與交易平台元數據。
鏈上去中心化交易平台
/onchain/*
取得 GeckoTerminal 上所列鏈上礦池和代幣的即時和歷史資料,包括價格、市值、交易量和流動性。
鏈上交易
/onchain/.../trades/*
從鏈上礦池和代幣中獲取或流式交易,包括交易哈希值、錢包地址、交易方向、交易規模和價值。
歷史走勢圖
/coins/.../market_chart/*
取得長達 13 年的歷史加密貨幣市場資料和價格走勢圖,精確度降至每 5 分鐘一次。
OHLC 和 OHLCV 走勢圖
/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 上架的即時和歷史 NFT 系列資料,包括最低價格、市場資料和中繼資料。
熱門
/onchain/.../trending_pools
/search/trending
取得 CoinGecko 上的熱門代幣,以及 GeckoTerminal 上的熱門礦池。
鏈上持有者
/onchain/.../top_holders
取得 GeckoTerminal 上代幣的熱門代幣持有者與歷史持有者趨勢。
鏈上錢包
/onchain/wallets/*
取得任何錢包地址的代幣餘額、交易、PnL 與原始代幣轉帳,包含各個持有的 USD 價值以及跨多個網路的流動性。
全球
/global/*
取得如總市值、交易量和市佔率等全球加密貨幣市場資料。
獲取全面、高精準度的資料範疇
所有主要網路中最廣泛的資產覆蓋範圍
覆蓋 CEX 和 DEX 上超過 36,000,000 個交易對
您可信賴的可靠基礎設施
支援所有主要區塊鏈,如以太坊、比特幣、Solana 等
具有秒級粒度的廣泛歷史數據
受信賴的資料 涵蓋加密貨幣與代幣化市場
嚴格的檢查和算法確保所有代幣資訊準確、可靠,且無操縱、詐騙或不良資料 — 為開發者和企業提供可靠的 Target,用於任務關鍵型應用程式。
我們從各種中心化交易平台和去中心化交易平台 Target 資料,應用我們專有的比特幣價格指數 (BPI) 作為參考基準,然後在篩選出異常值後,彙總各貨幣的市場價格。
開發人員、Vibe 編碼人員、研究人員的流暢使用,幾乎所有人
企業級效能 深受全球領先加密貨幣與金融應用程式的信賴
建立在企業級的安全性之上
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 使用者均可免費使用 Demo 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 為在 360+ 個區塊鏈網路上交易的 50M+ 種代幣提供豐富的鏈上市場資料,包括 Ethereum、Solana、TON、BNB Chain 和 Base。常見的鏈上資料類型包括:
- 代幣價格與流動性資料:從 DEX 取得即時與歷史代幣價格、流動性、交易等更多資料
- OHLCV 資料:使用開盤價、最高價、最低價、收盤價與交易量資料,以秒級解析度建立 K 線圖
- Launchpad 代幣: 取得 Pump.fun、Four.meme、Raydium Launchlab 等平台上代幣的 Bonding Curve (聯合曲線) 資料
- 安全資訊:擷取 GeckoTerminal Score、持有人分布及鑄造/凍結權限等指標,以驗證代幣的可信度
-
CoinGecko API 是否適合大型企業?
-
完全正確。CoinGecko API 經過大規模實戰驗證,並受到業界許多頂尖企業信賴,包括 Consensys、Chainlink、Coinbase、Ledger、Etherscan 等等。請查看我們的 案例研究,了解他們如何使用 CoinGecko API。
我們的 Enterprise 方案 提供:- 專屬資料存取 — 僅限 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)是基本版、Analyst 版、精簡版、專業版與專業版+的預設付款方式。
Analyst 版及以上方案的年度訂閱亦提供加密貨幣付款,可直接在結帳頁面選取此選項。
如需訂閱企業方案,請與我們聯絡 此處,我們的團隊將為您進一步說明包括美元銀行電匯在內的付款選項。 -
加密貨幣付款有哪些限制?
-
以下限制適用於加密貨幣付款:
- 僅適用於年度訂閱
- 續訂付款方式為手動 — 您將於訂閱到期前 14 日和 7 日收到續訂提醒
- 無法啟用超額計費
- 無法直接支援方案升級與降級 — 您只能進行取消。如果想變更方案,您得先取消,然後重新訂閱所需類型方案。
- 無法退款
-
超出限額時是如何收費?
- 每調用500,000次收取250美元。
-
CoinGecko API 如何計算 API 使用積分?
- 1 次呼叫 = 1 積分。呼叫任何端點僅計為 1 次呼叫。
-
我的調用次數(每月API額度)何時重置?
-
無論您的計費週期為何,您的調用次數從當月的第一天開始計算至最後一天為止。
如果您在當月第一天之後的某日開始訂閱,您仍將獲得該月所剩天數的完整調用額度。然後,在下一個月的第一天,您的調用額度將再度重置。 -
CoinGecko API 訂閱的退款政策為何?
- 所有款項必須在您使用計劃的生效/起始日,以及之後的每個循環計費週期之前支付),一律;不可退款(無論是全部還是部分)。
-
Demo、Basic、Analyst、Lite、Pro、Pro+ 和 Enterprise 方案有何區別?
-
- Demo 方案為一項免費方案,用於試用 CoinGecko API。非常適合測試和探索,但調用點數有限,並且每分鐘調用次數限制為 100 次。
- Basic 方案適合個人使用情境,提供較多的 API 調用點數、更高的速率限制,以及更頻繁的資料更新。
- 同時,Analyst、Lite、Pro,以及 Pro+ 方案專為嚴謹的分析工作與中小型專案所設計。這些方案提供更完整的 CoinGecko API 功能組合,包括即時資料、90+ 個 API endpoint,以及商業授權。其主要差異在於 API 調用點數與速率限制。
- 對於高用量的企業客戶,如需自訂方案以符合其業務需求(包括自訂授權、SLA、策略諮詢等),Enterprise 方案將是最佳選擇。
-
我對付費方案有興趣。付費方案有沒有提供購買前的試用服務?
- 針對企業方案,我們可為有意轉換方案的使用者提供最長 2 週的試用(視個別情況而定)。請與我們聯絡 此處,我們會盡快回應。請注意,我們的試用方案並不支援超額收費功能。
-
我的訂閱何時到期?
- 採用月訂閱方案的使用者,其單月的訂閱期間會在啟用日起算滿一個月之日到期。至於年訂閱制,其單年訂閱方案會在購買後365天內到期。請注意,系統會預設開啟自動續訂以確保我們為使用者提供的訂閱服務不中斷。
-
未使的請求數我能否累計到下一期使用?
- 我們暫時不提供將未使用的請求累計到下一個月使用之類的功能。在您的訂閱更新時,請求數就會重置。
-
我想取消我的訂閱,我應該怎麼做?
-
如果您想取消訂閱,僅需前往 開發者儀表板 並點擊綠色分頁中的「API 方案詳情」。
如果您在開發者儀表板上沒有看見該選項,請經由 此處 與我們的團隊聯絡以展開取消流程。 -
您是否提供 SLA?
- 是的,我們為企業客戶提供SLA。 請經由 此處 與我們聯絡以了解詳情。
-
我可以在哪裡找到我的API密鑰?
- 您的API密鑰僅會在您於開發人員設定畫面中生成該API密鑰時顯示。請注意,如果該API密鑰被洩露,您必須刪除這個密鑰並重新生成新的密鑰。
-
提出請求時,我應該在哪里傳送 Pro API 密鑰(任意付費方案)?
-
您可以透過以下兩種方式來提供您的 Pro API 密鑰:
1. 標頭: x-cg-pro-api-key
2. 查詢字串參數: x_cg_pro_api_key
注意: Pro API 密鑰目前僅供CoinGecko API付費方案訂戶使用,所有 API 密鑰請求都應以這個網域https://pro-api.coingecko.com為目標。建議您將 API 密鑰安全儲存在您自己的後端,並利用代理主機將密鑰插入需要的網址中。 -
資料多久會刷新或更新一次?
-
此操作因具體情況而異 - 但端點緩存全部為大約 1 到 5 分鐘,並且如未另作說明,大多數資料都以類似的時間間隔更新。Pro API(付費計畫)更新頻率通常更高,例如簡單/匯率端點為 30 秒。
這也意味著,您作為用戶應該嘗試限制自己的響應次數,以確保您不會因過度頻繁呼叫而浪費帶寬。 -
我可以透過 WebSocket 串流即時資料嗎?
-
是的,CoinGecko WebSockets 提供兩種主要的即時資料串流:
- 綜合全球市場價格 - 與單一交易平台串流來自單一場所未經驗證的原始 Tick 資料不同,我們的綜合價格引擎會持續擷取來自全球 2,000+ 個交易平台的即時交易資料。它會即時進行標準化、按成交量加權,並即時過濾異常 Tick 資料,以提供機構級的全球市場價格代表資訊。
- 鏈上 DEX 資料 - 透過 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您可能無權存取此端點,例如「此請求僅限Pro API訂閱者」。您可能需要在此處訂閱付費方案:此處。1020(存取遭拒)這是因為違反了CDN防火牆規則。CORS錯誤如果伺服器未傳回所需的CORS標頭,就會發生CORS錯誤。您可以在此處瞭解更多相關資訊並嘗試推薦的解決方案:此處。
資料層 適用於領先的加密貨幣與金融應用程式