CoinGlass API 概覽

CoinGlass API 匯集全球 30+ 家主流交易所的即時與歷史數據,覆蓋合約、現貨、期權、ETF 與鏈上市場,透過統一接口減少多交易所接入與數據整理工作。數據粒度最細可達原始訂單級別,涵蓋訂單簿(L2&L3)、持倉量、資金費率、爆倉與訂單流等數據,支援量化研究、策略回測、風險監控和應用開發。擁有市場最長的歷史數據,具體歷史覆蓋範圍與可用粒度因數據類型、交易所及交易對而異。

本頁要點
項目內容
數據範圍合約、現貨、期權、ETF、鏈上、指標、財經與資訊
調用方式REST(JSON)、WebSocket 即時推送、MCP(AI 工具)
Base URLhttps://open-api-v4.coinglass.com
認證請求標頭 CG-API-KEY,API Key 隨訂閱提供
接口數量168 個 REST 接口,4 個 WebSocket 頻道
機器可讀入口llms.txt;任意文件頁地址末尾加 .md
Base URL
https://open-api-v4.coinglass.com
認證方式
請求標頭 CG-API-KEY
接口數量
168 個 REST,4 個 WebSocket 頻道

快速開始

三步完成第一次調用。完整教程(含錯誤處理與更多範例)見快速開始。

  1. 獲取 API Key:註冊 CoinGlass 帳號並訂閱 API 後,在個人中心查看 API Key。
  2. 發送請求:在請求標頭 CG-API-KEY 中攜帶密鑰。下面的範例查詢所有支援的合約幣種(接口文件)。
  3. 讀取響應: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 即時頻道。

分類接口數包含文件
合約63交易市場、持倉、資金費率、多空比、爆倉與清算、訂單簿、Hyperliquid、主動買賣查看
現貨18交易市場、訂單簿、主動買賣、足跡圖與 CVD查看
期權4最大痛點、期權數據、交易所持倉與成交量歷史查看
鏈上7交易所資產與餘額、鏈上轉帳、代幣解鎖查看
ETF17比特幣、以太坊、Solana、XRP、HYPE ETF 資金流,灰度基金持倉與溢價查看
指標53技術指標、CGDI 與 CDRI 指數、週期與鏈上指標、宏觀對比查看
財經與資訊5經濟數據、財經事件、央行動態、新聞與快訊查看
帳號1帳號等級查詢查看
WebSocket4爆倉訂單、現貨與合約成交、合約行情快照查看

核心業務場景與推薦接口組合

CoinGlass 將跨交易所持倉、資金費率、爆倉、清算模型與訂單流連接起來,幫助你觀察價格背後的市場結構、跟蹤資金動向,並用歷史數據驗證自己的判斷。

場景想解決的問題核心數據與應用
市場結構看懂行情背後的市場結構價格變化時,持倉、費率和主動買賣發生了什麼變化?

持倉量 + 資金費率 + 大戶多空比 + CVD
構建市場結構面板,對照倉位、資金費率與成交變化。
關鍵價位與風險觀察關鍵價位與市場風險當前價格附近,清算模型、盤口掛單和實際爆倉分別呈現什麼狀態?

清算熱力圖/地圖 + 訂單簿 + 實際爆倉
構建價格分佈與風險監控面板,分別展示模型、掛單和強平事件。
資金與倉位跟蹤資金與大額倉位動向ETF 資金流如何變化?巨鯨在開什麼倉、平什麼倉?

ETF 資金流 + Hyperliquid 鯨魚提醒與持倉
構建資金動向看板與投研報告,跟蹤基金淨流入和大額倉位變化。
研究與系統接入驗證策略並接入自己的系統這些指標在歷史上有什麼表現,如何持續用於研究和監控?

多市場歷史數據 + REST 查詢 + WebSocket 推送
構建回測數據集與持續更新的數據服務,接入自己的研究或交易系統。

查看各場景的推薦接口、組合步驟與數據口徑(Common Workflows)。

在 AI 工具中使用 CoinGlass 數據

文件和數據都可以被 AI Agent 直接讀取與調用。

API 等級與權限

API 等級的主要差別是可用數據、歷史範圍、請求上限和使用授權。較高等級包含較低等級的公開接口能力。

API 等級核心能力K 線最細週期請求/分鐘使用範圍
業餘基礎行情、持倉、費率、多空比與 ETF 數據4 小時30個人
創業增加 CVD、資金流、Hyperliquid 鯨魚提醒與錢包倉位30 分鐘80個人
標準增加 WebSocket、爆倉訂單、訂單簿熱力圖與大額掛單1 分鐘300商業
專業增加清算熱力圖/地圖、足跡圖與按標籤的倉位分析;分鐘級歷史更長1 分鐘1,200商業
企業定製速率、數據粒度、歷史範圍及 CSV/批量交付按約定定製商業

“K 線最細週期”指適用歷史接口的 interval 權限,不是數據更新頻率,也不代表原始訂單數據的粒度;ETF 日線、即時列表等按各接口說明。

查看價格、全部權限與歷史範圍 · 按接口查最低等級 · 了解企業定製

下一步

熱門加密貨幣數據接口

開發者最常用的 8 類數據:

關於 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 等級有什麼區別?

API 等級決定可用的接口範圍、每分鐘請求次數和歷史數據深度。各 API 等級的完整對比見API 等級與權限,價格見定價頁。

數據可以用於商業產品嗎?

可以,商業使用需要標準及以上的 API 等級,具體以服務條款為準。

CoinGlass API 有免費版嗎?

API Key 隨訂閱提供,業餘是最低的訂閱等級。月付與年付價格見API 等級與權限。

可以用哪些編程語言調用 CoinGlass API?

任何能發送 HTTPS 請求的語言都可以,例如 Python、JavaScript、Go、Java、PHP、C#。文件提供 cURL、Python 和 JavaScript 範例,也可以透過 MCP 服務在 AI 工具中直接查詢。

📘

需要更多數據?

自訂速率限制、更長的歷史數據、CSV 與批量導出等需求,可以透過企業定製獲取。