業務場景

從看懂市場結構、觀察關鍵價位、跟蹤資金與倉位,到驗證策略並接入自己的系統,了解 CoinGlass 核心數據分別能回答什麼問題、如何組合,以及可以構建哪些工具。

從你想了解的問題開始

CoinGlass 將分散在不同市場的持倉、資金費率、爆倉與訂單流,以及清算模型、ETF 和公開錢包倉位連接起來。以下四個場景說明這些數據能提供哪些觀察依據,以及如何將它們用於自己的工具。

想了解什麼主要觀察依據可以構建什麼
看懂行情背後的市場結構持倉、費率、倉位結構與主動買賣的同步變化市場結構面板、幣種觀察工具
觀察關鍵價位與市場風險清算模型分佈、盤口掛單與實際強平事件價格分佈看板、風險監控與自訂提醒
跟蹤資金與大額倉位動向ETF 淨流入/流出、Hyperliquid 大額開平倉與當前倉位資金動向看板、巨鯨觀察工具、投研報告
驗證策略並接入自己的系統歷史序列、持續查詢與已支援的即時推送回測數據集、研究數據庫、系統數據服務

接口組合的權限按其中最高要求選擇;用於商業產品時至少需要標準等級。價格、請求上限與歷史範圍見API 等級與權限。

看懂行情背後的市場結構

用戶的問題:價格變化時,持倉規模是否同步變化?資金費率、大戶倉位與主動買賣分別呈現什麼狀態?

觀察依據推薦接口能看見什麼
持倉規模聚合持倉歷史;需要單所對照時使用交易對持倉歷史幣種聚合持倉與指定交易對的持倉變化
資金費率持倉加權資金費率參與市場按持倉加權後的費率變化
大戶倉位結構大戶持倉多空比指定交易所、交易對的大戶多空倉位比例
主動成交方向合約聚合 CVD;可對照現貨聚合 CVD所選市場主動買入與主動賣出的差額及累積變化
對應價格合約價格歷史與上述指標按時間對照的價格序列

組合方式:

  1. 選擇關注幣種、交易所範圍和週期;價格與大戶多空比使用指定交易對,聚合持倉、加權費率與聚合 CVD 使用各自的市場範圍。
  2. 以價格為時間軸,並列展示持倉、費率、多空比和 CVD。例如,價格上漲時,可以同時觀察持倉是否增加、費率如何變化,以及主動買賣差額的方向。
  3. 分別保留各指標的統計範圍和單位,形成幣種觀察面板;將觀察到的關係交給歷史研究驗證。

權限:基礎持倉、費率、多空比與價格歷史從業餘起,聚合 CVD 從創業起;適用 K 線接口的週期權限見時間週期與 interval。

數據口徑:持倉金額不是資金淨流入,多空比也不是主動成交量。聚合市場與單交易對數據的範圍不同。資金費率 K 線包含預測口徑,不能直接作為實際結算現金流;CVD 的累計起點由本次請求範圍決定,跨市場比較需統一起點和單位。

觀察關鍵價位與市場風險

用戶的問題:當前價格附近,模型顯示哪些清算密集區域?買賣盤掛單分佈在哪裡?實際爆倉是否正在增加?

觀察依據推薦接口能看見什麼
模型清算分佈幣種清算熱力圖模型 1/模型 2/模型 3 + 清算地圖模型清算強度在時間和價格維度的分佈
盤口流動性訂單簿歷史(熱力圖) + 大額訂單簿買賣盤各價格檔位的掛單,以及被跟蹤的大額掛單
已發生的強平WebSocket 爆倉推送 + REST 爆倉訂單即時爆倉事件,以及最近 7 天內的歷史訂單

組合方式:

  1. 以同一標的關聯清算分佈與訂單簿數據,分別展示模型強度和掛單數量,並標註各自覆蓋的交易所與交易對。
  2. 接入實際爆倉訂單,按時間、方向與金額展示強平事件;可按自己的業務閾值生成提醒。
  3. 對照價格變化前後的模型分佈、掛單變化和實際爆倉,形成盤中風險監控記錄。需要快速查看模型關鍵價位時,可補充清算最大痛點。

權限:訂單簿熱力圖、大額掛單與 REST/WebSocket 爆倉訂單從標準起;清算熱力圖、地圖與最大痛點從專業起。使用上表完整組合需要專業及以上。

數據口徑:清算強度是模型結果,不能當作實際或預計爆倉金額;模型分佈也不代表價格一定到達某處。掛單可能成交或撤銷,實際爆倉金額來自強平訂單。不同模型分別展示;疊圖時按各接口欄位說明轉換秒/毫秒和數量單位。

跟蹤資金與大額倉位動向

用戶的問題:ETF 資金流如何變化?Hyperliquid 上的大額錢包在開什麼倉、平什麼倉,當前持有什麼倉位?

觀察依據推薦接口能看見什麼
基金資金流BTC ETF 資金流 + ETH ETF 資金流每日總淨流入/流出與各基金明細
大額開平倉記錄Hyperliquid 鯨魚提醒最新的鯨魚開倉、平倉提醒
當前倉位詳情Hyperliquid 鯨魚持倉;按地址查詢使用錢包倉位當前倉位、槓桿、未實現盈虧與強平價

組合方式:

  1. 將 ETF 資金流按 UTC 日期整理為基金資金流圖表,展示總額與基金明細。
  2. 將鯨魚提醒按錢包、幣種與時間展示;查詢當前持倉,補充倉位規模和風險相關欄位。
  3. 在同一研究看板中分區展示基金資金流與大額錢包倉位,附各自更新時間,生成日報或持續觀察記錄。

權限:ETF 接口從業餘起,Hyperliquid 鯨魚提醒、鯨魚持倉與錢包倉位從創業起;商業產品至少需要標準等級。

數據口徑:ETF 資金流與錢包倉位變化是不同口徑,不能相加或據此認定資金在兩者之間轉移。鯨魚提醒不包含完整倉位詳情,當前倉位也不能替代完整歷史;公開錢包地址本身不代表已知機構身份。

ETF 資金流日報

  1. 按 timestamp 對應的 UTC 日期整理總淨流入和基金明細;flow_usd 為美元金額,正數為淨流入,負數為淨流出。
  2. 將明細中的 etf_ticker 與 BTC ETF 列表或 ETH ETF 列表的 ticker 匹配,補充基金名稱、類型和當前 AUM,只匹配資金流實際返回的基金。
  3. 總淨流入已包含基金明細,不能重複相加;當前 AUM 附上 update_timestamp,不能當作歷史每日規模。缺失日期保留為空,披露數據更新後覆蓋同日期記錄。該組合所用接口從業餘起,商業產品至少需要標準等級。

驗證策略並接入自己的系統

用戶的問題:上述指標在歷史上有什麼表現?如何把歷史研究與持續更新的數據接入自己的研究或交易系統?

接入階段推薦接口或文件可以構建什麼
建立歷史數據集價格歷史 + 聚合持倉 + 資金費率歷史 + 幣種爆倉歷史;按需加入聚合 CVD按時間組織的研究數據庫與回測樣本
持續更新數據透過 REST 按所選接口的更新頻率查詢;接入方式見快速開始定期更新的市場狀態、指標與報告
接收即時事件WebSocket 爆倉推送 + 合約行情快照即時事件處理與市場監控服務
批量與定製交付企業定製CSV、批量歷史、自訂速率、歷史範圍與交付結構

組合方式:

  1. 固定標的、市場範圍、週期和單位,按各接口的時間參數與分頁規則獲取歷史,保留來源、時間戳和缺失狀態。
  2. 基於已完成週期計算研究特徵,劃分回測區間,驗證自己設定的規則;CVD 分段下載時按主動買入減主動賣出續算,資金費率 K 線不直接作為實際結算現金流。
  3. 運行階段按各 REST 接口的更新節奏維護數據,按需訂閱已支援的 WebSocket 頻道,處理心跳、重連及數據去重。即時推送的覆蓋範圍以各頻道說明為準。

權限與歷史範圍:基礎歷史接口從業餘起,CVD 從創業起,WebSocket 從標準起。適用基礎 K 線接口的最短週期為業餘 4 小時、創業 30 分鐘、標準及以上 1 分鐘;可獲取的歷史長度因數據類型、交易所、交易對及等級而異,見API 等級與權限。

接入邊界:CoinGlass 提供的是數據,策略計算、回測和交易執行由你的系統實現。REST 與 WebSocket 不保證存在逐項對應的完整歷史;例如爆倉訂單可在最近 7 天範圍內補查,其他頻道需按各自說明設計存儲與恢復流程。合併數據時不能僅憑時間戳去重。

接入與數據對齊

  • REST 請求在請求標頭攜帶 CG-API-KEY;先確認 HTTP 狀態和業務 code,再讀取 data,見快速開始。
  • 先核對支援的合約交易對與現貨交易對,再確認所選數據接口是否覆蓋該市場。跨交易所聚合、單交易對與鏈上錢包分別標註統計範圍。
  • 按各接口欄位說明轉換秒/毫秒、幣數量/美元及百分數;需要分段獲取歷史時,見時間戳與分頁。
  • WebSocket 連接與心跳見接入說明,限流和異常處理見錯誤碼與頻率限制;全部端點見接口總覽。