獲取某個幣種的清算熱力圖數據(模型 1):價格縱軸、帶時間的價格 K 線,以及每個時間、價格位置的清算強度。適合畫清算熱力圖,觀察清算密集的價格區域。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 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 · 響應範例見右側面板。
| 欄位 | 類型 | 必返 | 說明 |
|---|---|---|---|
code | string | 是 | 業務狀態碼,"0" 表示成功 |
msg | string | 否 | 結果說明 |
data | object | 是 | 熱力圖數據 |
data.y_axis | array of number | 是 | Y 軸座標,即價格檔;liquidation_leverage_data 第 1 位的索引指向這裡 |
data.liquidation_leverage_data | array of array | 是 | 熱力點陣列,每個元素為 [X 軸索引, Y 軸索引, 清算強度]:第 0 位是整數,對應 price_candlesticks 的位置(從 0 開始);第 1 位是整數,對應 y_axis 的位置(從 0 開始);第 2 位是該位置的清算強度,模型計算結果,不能當作金額 |
data.price_candlesticks | array of array | 是 | 價格 K 線陣列,每個元素為 [開始時間, 開盤價, 最高價, 最低價, 收盤價, 成交量]:第 0 位是 K 線週期開始時間,秒級時間戳(UTC);第 1~4 位是價格,字串;第 5 位是成交額,美元,字串 |
data.update_time | integer(int64) | 是 | 結果生成時間,毫秒時間戳(UTC) |
liquidation_leverage_data 每個元素的位置
| 位置 | 含義 | 說明 |
|---|---|---|
| 0 | X 軸索引 | 整數,從 0 開始,對應 price_candlesticks 中同一位置的 K 線(即時間) |
| 1 | Y 軸索引 | 整數,從 0 開始,對應 y_axis 中同一位置的價格 |
| 2 | 清算強度 | 該時間、該價格處的清算強度,模型計算結果,不能當作實際清算金額 |
price_candlesticks 每個元素的位置
| 位置 | 含義 | 說明 |
|---|---|---|
| 0 | 開始時間 | K 線週期的開始時間,秒級時間戳(UTC) |
| 1 | 開盤價 | 字串 |
| 2 | 最高價 | 字串 |
| 3 | 最低價 | 字串 |
| 4 | 收盤價 | 字串 |
| 5 | 成交量(美元) | 該 K 線的成交額,單位美元,字串 |
API 等級
只有下表中標為可以的 API 等級能調用本接口。各等級價格見 API 等級。
| API 等級 | 能否調用 |
|---|---|
| 業餘 | ❌ 不可以 |
| 創業 | ❌ 不可以 |
| 標準 | ❌ 不可以 |
| 專業 | ✅ 可以 |
| 企業 | ✅ 可以 |
用 AI 調用本接口
選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,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 線畫在同一張圖上即可。
清算熱力圖和清算地圖有什麼區別?
熱力圖帶時間軸,能看到清算強度隨時間的變化;清算地圖(如「幣種清算地圖」)沒有時間軸,只按價格檔給出清算強度,適合畫柱狀分佈圖。
