幣種清算熱力圖(模型 1)

獲取某個幣種的清算熱力圖數據(模型 1):價格縱軸、帶時間的價格 K 線,以及每個時間、價格位置的清算強度。適合畫清算熱力圖,觀察清算密集的價格區域。

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

以下 API 等級可以調用本接口:專業 企業

更新頻率即時

響應數據

data 由四部分組成:y_axis 是價格縱軸,price_candlesticks 是橫軸上按時間排列的價格 K 線,liquidation_leverage_data 是熱力點,update_time 是結果生成時間。熱力點用索引指向前兩者:[i, j, v] 表示在 price_candlesticks[i] 這根 K 線的時間、y_axis[j] 這個價格處,清算強度為 v。

⚠️

注意強度和時間單位

liquidation_leverage_data 每個陣列為 [橫軸索引, 價格索引, 清算強度]:橫軸索引對應 price_candlesticks 的位置,價格索引對應 y_axis 的位置。清算強度是模型計算結果,不能當作實際清算金額或美元金額,展示時不要加貨幣符號;不同位置的強度相加,也不能當作預計清算總額。

price_candlesticks 中第一個值是 K 線週期的開始時間,單位是秒;而 update_time(結果生成時間)的單位是毫秒。兩者不要混用。

200 · application/json · 響應範例見右側面板。

欄位類型必返說明
codestring是業務狀態碼,"0" 表示成功
msgstring否結果說明
dataobject是熱力圖數據
data.y_axisarray of number是Y 軸座標,即價格檔;liquidation_leverage_data 第 1 位的索引指向這裡
data.liquidation_leverage_dataarray of array是熱力點陣列,每個元素為 [X 軸索引, Y 軸索引, 清算強度]:第 0 位是整數,對應 price_candlesticks 的位置(從 0 開始);第 1 位是整數,對應 y_axis 的位置(從 0 開始);第 2 位是該位置的清算強度,模型計算結果,不能當作金額
data.price_candlesticksarray of array是價格 K 線陣列,每個元素為 [開始時間, 開盤價, 最高價, 最低價, 收盤價, 成交量]:第 0 位是 K 線週期開始時間,秒級時間戳(UTC);第 1~4 位是價格,字串;第 5 位是成交額,美元,字串
data.update_timeinteger(int64)是結果生成時間,毫秒時間戳(UTC)

liquidation_leverage_data 每個元素的位置

位置含義說明
0X 軸索引整數,從 0 開始,對應 price_candlesticks 中同一位置的 K 線(即時間)
1Y 軸索引整數,從 0 開始,對應 y_axis 中同一位置的價格
2清算強度該時間、該價格處的清算強度,模型計算結果,不能當作實際清算金額

price_candlesticks 每個元素的位置

位置含義說明
0開始時間K 線週期的開始時間,秒級時間戳(UTC)
1開盤價字串
2最高價字串
3最低價字串
4收盤價字串
5成交量(美元)該 K 線的成交額,單位美元,字串

API 等級

只有下表中標為可以的 API 等級能調用本接口。各等級價格見 API 等級。

API 等級能否調用
業餘❌ 不可以
創業❌ 不可以
標準❌ 不可以
專業✅ 可以
企業✅ 可以

用 AI 調用本接口

選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,AI 會先讀取本頁說明,再直接給出結果;也可以點「複製」,把完整提示詞貼上到你常用的 AI 工具裡。

用 Python 畫熱力圖
讓 AI 寫代碼,獲取 BTC 的清算熱力圖並畫出來。
找出清算密集位置
讓 AI 寫代碼,列出清算強度最高的價格位置。
看懂這個接口
讓 AI 用白話解釋返回結構和清算強度。

本接口透過 REST API 提供數據,可使用上方提示詞讓 AI 編寫調用代碼。MCP 可調用的工具見 CoinGlass MCP。

應用場景

場景說明
識別清算密集區找出清算強度高的價格區域,了解價格靠近哪些位置時可能觸發較多強平。
規劃止損和掛單參考清算密集區規劃止損和掛單位置,避開容易被連環強平波及的價格。
復盤行情對照 K 線回看大幅波動前後清算強度分佈的變化。
行情看板在看板中展示幣種的清算熱力圖,配合價格觀察槓桿集中的位置。

相關接口

接口區別
幣種清算熱力圖(模型 2)同一類熱力圖,用模型 2 計算
幣種清算熱力圖(模型 3)同一類熱力圖,用模型 3 計算
交易對清算熱力圖(模型 1)單個交易所、單個交易對的熱力圖
幣種清算地圖只按價格檔給出清算強度,不帶時間軸

常見問題

清算強度是美元金額嗎?

不能按美元金額理解。清算強度是模型計算結果,不能當作實際清算金額,也不能當作美元或 USDT 金額,展示時不要加貨幣符號。

時間戳為什麼是 10 位數?

price_candlesticks 每個元素的第 0 位是秒級時間戳,而 update_time 是毫秒時間戳。換算時間前請先統一單位,例如把秒乘以 1000。

symbol 應該填什麼?

這裡填幣種,例如 BTC,不是交易對。要看單個交易所某個交易對的熱力圖,請使用「交易對清算熱力圖(模型 1)」。

模型 1、2、3 有什麼區別?

三個模型分別計算,清算強度不能跨模型比較或相加。例如 range=12h 時,模型 1、2 的 price_candlesticks 每根間隔 5 分鐘,模型 3 每根間隔 1 分鐘,三者 y_axis 的價格範圍也不同。

深入了解:清算熱力圖

什麼是清算熱力圖?

清算熱力圖把模型估算的強平分佈畫在時間—價格平面上:橫軸是時間,縱軸是價格,顏色越亮表示該時間、該價格處的清算強度越高。

怎麼用返回數據畫出熱力圖?

以 price_candlesticks 的長度為列數、y_axis 的長度為行數建一個矩陣,把每個 [i, j, v] 填到第 j 行第 i 列,再把 K 線畫在同一張圖上即可。

清算熱力圖和清算地圖有什麼區別?

熱力圖帶時間軸,能看到清算強度隨時間的變化;清算地圖(如「幣種清算地圖」)沒有時間軸,只按價格檔給出清算強度,適合畫柱狀分佈圖。

Query Params
string
required
Defaults to BTC

幣種代碼,例如 BTC、ETH、SOL。可查詢的幣種見「支援的幣種」接口。

string
required
Defaults to 3d

圖表的時間範圍,例如 3d。可選 12h、24h、3d、7d、30d、90d、180d、1y。

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json