CoinGlass API 匯集全球 30+ 家主流交易所的即時與歷史數據,覆蓋合約、現貨、期權、ETF 與鏈上市場,透過統一接口減少多交易所接入與數據整理工作。數據粒度最細可達原始訂單級別,涵蓋訂單簿(L2&L3)、持倉量、資金費率、爆倉與訂單流等數據,支援量化研究、策略回測、風險監控和應用開發。擁有市場最長的歷史數據,具體歷史覆蓋範圍與可用粒度因數據類型、交易所及交易對而異。
| 項目 | 內容 |
|---|---|
| 數據範圍 | 合約、現貨、期權、ETF、鏈上、指標、財經與資訊 |
| 調用方式 | REST(JSON)、WebSocket 即時推送、MCP(AI 工具) |
| Base URL | https://open-api-v4.coinglass.com |
| 認證 | 請求標頭 CG-API-KEY,API Key 隨訂閱提供 |
| 接口數量 | 168 個 REST 接口,4 個 WebSocket 頻道 |
| 機器可讀入口 | llms.txt;任意文件頁地址末尾加 .md |
快速開始
三步完成第一次調用。完整教程(含錯誤處理與更多範例)見快速開始。
- 獲取 API Key:註冊 CoinGlass 帳號並訂閱 API 後,在個人中心查看 API Key。
- 發送請求:在請求標頭
CG-API-KEY中攜帶密鑰。下面的範例查詢所有支援的合約幣種(接口文件)。 - 讀取響應:HTTP 狀態碼為 200 且
code為"0"表示成功,結果在data欄位中。全部返回碼見錯誤碼與頻率限制。
curl --request GET \
--url 'https://open-api-v4.coinglass.com/api/futures/supported-coins' \
--header 'CG-API-KEY: YOUR_API_KEY'import requests
url = "https://open-api-v4.coinglass.com/api/futures/supported-coins"
headers = {"CG-API-KEY": "YOUR_API_KEY"}
resp = requests.get(url, headers=headers)
print(resp.json())const res = await fetch(
"https://open-api-v4.coinglass.com/api/futures/supported-coins",
{ headers: { "CG-API-KEY": "YOUR_API_KEY" } }
);
console.log(await res.json());響應範例(data 已截斷):
{
"code": "0",
"data": ["BTC", "ETH", "SOL", "XRP", "BNB"]
}數據範圍
168 個 REST 接口按市場分為 8 類,另有 4 個 WebSocket 即時頻道。
核心業務場景與推薦接口組合
CoinGlass 將跨交易所持倉、資金費率、爆倉、清算模型與訂單流連接起來,幫助你觀察價格背後的市場結構、跟蹤資金動向,並用歷史數據驗證自己的判斷。
| 場景 | 想解決的問題 | 核心數據與應用 |
|---|---|---|
| 市場結構 | 看懂行情背後的市場結構 | 價格變化時,持倉、費率和主動買賣發生了什麼變化? 持倉量 + 資金費率 + 大戶多空比 + CVD 構建市場結構面板,對照倉位、資金費率與成交變化。 |
| 關鍵價位與風險 | 觀察關鍵價位與市場風險 | 當前價格附近,清算模型、盤口掛單和實際爆倉分別呈現什麼狀態? 清算熱力圖/地圖 + 訂單簿 + 實際爆倉 構建價格分佈與風險監控面板,分別展示模型、掛單和強平事件。 |
| 資金與倉位 | 跟蹤資金與大額倉位動向 | ETF 資金流如何變化?巨鯨在開什麼倉、平什麼倉? ETF 資金流 + Hyperliquid 鯨魚提醒與持倉 構建資金動向看板與投研報告,跟蹤基金淨流入和大額倉位變化。 |
| 研究與系統接入 | 驗證策略並接入自己的系統 | 這些指標在歷史上有什麼表現,如何持續用於研究和監控? 多市場歷史數據 + REST 查詢 + WebSocket 推送 構建回測數據集與持續更新的數據服務,接入自己的研究或交易系統。 |
查看各場景的推薦接口、組合步驟與數據口徑(Common Workflows)。
在 AI 工具中使用 CoinGlass 數據
API 等級與權限
API 等級的主要差別是可用數據、歷史範圍、請求上限和使用授權。較高等級包含較低等級的公開接口能力。
| API 等級 | 核心能力 | K 線最細週期 | 請求/分鐘 | 使用範圍 |
|---|---|---|---|---|
| 業餘 | 基礎行情、持倉、費率、多空比與 ETF 數據 | 4 小時 | 30 | 個人 |
| 創業 | 增加 CVD、資金流、Hyperliquid 鯨魚提醒與錢包倉位 | 30 分鐘 | 80 | 個人 |
| 標準 | 增加 WebSocket、爆倉訂單、訂單簿熱力圖與大額掛單 | 1 分鐘 | 300 | 商業 |
| 專業 | 增加清算熱力圖/地圖、足跡圖與按標籤的倉位分析;分鐘級歷史更長 | 1 分鐘 | 1,200 | 商業 |
| 企業 | 定製速率、數據粒度、歷史範圍及 CSV/批量交付 | 按約定 | 定製 | 商業 |
“K 線最細週期”指適用歷史接口的 interval 權限,不是數據更新頻率,也不代表原始訂單數據的粒度;ETF 日線、即時列表等按各接口說明。
查看價格、全部權限與歷史範圍 · 按接口查最低等級 · 了解企業定製
下一步
熱門加密貨幣數據接口
開發者最常用的 8 類數據:
- 比特幣持倉量 API
持倉量(Open Interest),全市場與單交易所持倉 K 線 - 資金費率 API
資金費率(Funding Rate),各交易所永續合約費率與歷史 - 爆倉數據 API
爆倉(Liquidation)歷史、爆倉訂單與即時推送 - 清算熱力圖 API
多模型清算熱力圖與清算地圖 - 多空比 API
多空比(Long/Short Ratio),帳戶與大戶持倉多空比 - 比特幣 ETF 資金流 API
現貨 ETF 淨流入、淨資產與溢價 - Hyperliquid 巨鯨數據 API
巨鯨持倉、錢包盈虧分佈 - 恐懼與貪婪指數 API
加密市場情緒指數歷史
關於 CoinGlass API
什麼是 CoinGlass API
CoinGlass API V4 是一款專業級加密市場數據與分析 API,提供對全球主流加密貨幣交易所中衍生品、期權、現貨、ETF 及鏈上市場的即時與歷史數據的統一訪問。作為 CoinGlass 數據平台的下一代演進版本,API V4 採用了更加結構化、可擴展、以分析為核心的 API 架構。
CoinGlass 最初以行業領先的加密衍生品數據而聞名,長期穩定地提供高度結構化的核心指標,包括未平倉合約(Open Interest)、資金費率(Funding Rate)、爆倉事件、爆倉熱力圖、爆倉地圖、多空比以及衍生品資金流向等。隨著 API V4 的發佈,CoinGlass 在此基礎上大幅擴展了數據能力,進一步覆蓋更深層次的市場結構與分析數據,包括現貨訂單簿、L2 與 L3 級別的訂單流數據、鯨魚與大額持倉行為、ETF 淨流入、鏈上儲備以及宏觀加密市場指標。
CoinGlass API V4 核心亮點
- 聚合全球 30+ 家主流交易所的數據,包括 Binance、OKX、Bybit、Coinbase 等,覆蓋衍生品與現貨市場。
- 覆蓋合約、現貨與期權市場,支援 250,000+ 個交易標的。
- 精細化的即時與歷史數據訪問,包括資金費率、未平倉合約、價格 OHLC、爆倉、多空比、鯨魚指標及市場結構數據
- 先進的訂單簿與訂單流分析能力,提供 L2 與 L3 訂單簿深度、流動性分佈及大額訂單追蹤
- 擴展的宏觀與鏈上數據集,涵蓋 ETF 資金流向、鏈上儲備、ERC20 轉帳,以及加密恐慌與貪婪指數、Stock-to-Flow、彩虹圖等宏觀指標
- 開發者友好的 RESTful API 設計,具備統一的響應結構,支援分頁、篩選,滿足可擴展的生產級應用需求
可以獲取哪些加密市場數據
合約市場可以獲取持倉量、資金費率、多空比、爆倉訂單、清算熱力圖、訂單簿深度、主動買賣量與足跡圖;現貨市場可以獲取交易對行情、訂單簿、主動買賣與資金流入流出;期權、ETF 與鏈上方向覆蓋期權最大痛點、比特幣與以太坊等現貨 ETF 的資金流、交易所資產儲備和鏈上大額轉帳。指標類接口提供 RSI、MACD 等技術指標,CGDI 與 CDRI 指數,以及 Ahr999、彩虹圖、恐懼與貪婪指數等週期指標。
誰在使用 CoinGlass API
CoinGlass API 可用於個人市場觀察、專業交易分析、量化研究、機構投研與數據產品開發。可按業務場景選擇核心數據與接口組合,再根據所需接口、時間週期和使用授權選擇 API 等級。
常見問題
如何獲取 CoinGlass API Key?
註冊 CoinGlass 帳號並訂閱 API 等級後,在個人中心查看 API Key。調用接口時,在請求標頭 CG-API-KEY 中攜帶密鑰。
CoinGlass API 支援哪些交易所?
覆蓋 Binance、OKX、Bybit、Coinbase 等主流交易所。完整列表可以透過支援的交易所接口即時查詢。
數據可以用於商業產品嗎?
可以,商業使用需要標準及以上的 API 等級,具體以服務條款為準。
CoinGlass API 有免費版嗎?
API Key 隨訂閱提供,業餘是最低的訂閱等級。月付與年付價格見API 等級與權限。
可以用哪些編程語言調用 CoinGlass API?
任何能發送 HTTPS 請求的語言都可以,例如 Python、JavaScript、Go、Java、PHP、C#。文件提供 cURL、Python 和 JavaScript 範例,也可以透過 MCP 服務在 AI 工具中直接查詢。
需要更多數據?自訂速率限制、更長的歷史數據、CSV 與批量導出等需求,可以透過企業定製獲取。
