獲取過去 7 天內的爆倉訂單明細,每條包含交易所、交易對、爆倉價格、成交金額(美元)、方向和時間。可按最小金額過濾,適合做大額爆倉提醒。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等級可以調用本接口:標準 專業 企業
響應數據
data 為陣列,每個元素是一筆爆倉訂單,按 time 從新到舊排列。同一毫秒可能有多筆不同的訂單,不能只用 time 去重。
只能查詢最近 7 天本接口只提供過去 7 天內的爆倉訂單。
start_time、end_time都必須在最近 7 天內;需要更長的歷史,請使用「交易對爆倉歷史」等按週期彙總的接口。
200 · application/json · 響應範例見右側面板。
| 欄位 | 類型 | 必返 | 說明 |
|---|---|---|---|
code | string | 是 | 業務狀態碼,"0" 表示成功 |
msg | string | 否 | 結果說明 |
data | array of object | 是 | 爆倉訂單陣列,每個元素是一筆訂單 |
data[].exchange_name | string | 是 | 交易所名稱,大寫,例如 BINANCE、HTX |
data[].symbol | string | 是 | 交易對,按交易所的原生寫法,例如 BTCUSDT、BTC-USDT |
data[].base_asset | string | 是 | 幣種 |
data[].price | number | 是 | 爆倉價格 |
data[].usd_value | number | 是 | 成交金額,美元 |
data[].side | integer | 是 | 訂單成交方向:1 為買入,2 為賣出;不要直接換算成多單爆倉或空單爆倉 |
data[].time | integer(int64) | 是 | 爆倉發生時間,毫秒時間戳(UTC) |
API 等級
只有下表中標為可以的 API 等級能調用本接口。各等級價格見 API 等級。
| API 等級 | 能否調用 |
|---|---|
| 業餘 | ❌ 不可以 |
| 創業 | ❌ 不可以 |
| 標準 | ✅ 可以 |
| 專業 | ✅ 可以 |
| 企業 | ✅ 可以 |
用 AI 調用本接口
選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,AI 會先讀取本頁說明,再直接給出結果;也可以點「複製」,把完整提示詞貼上到你常用的 AI 工具裡。
本接口透過 REST API 提供數據,可使用上方提示詞讓 AI 編寫調用代碼。MCP 可調用的工具見 CoinGlass MCP。
應用場景
| 場景 | 說明 |
|---|---|
| 大額爆倉提醒 | 設定 min_liquidation_amount 過濾小單,出現大額爆倉時第一時間推送。 |
| 爆倉流水展示 | 在網站或看板中即時滾動展示最新的爆倉訂單。 |
| 行情復盤 | 回看最近 7 天某次急漲急跌期間的逐筆爆倉,了解強平集中在哪些價格。 |
| 統計分析 | 按交易所、方向彙總訂單數量和金額,比較各平台的強平規模。 |
相關接口
| 接口 | 區別 |
|---|---|
| 爆倉訂單(WebSocket) | 透過 WebSocket 即時推送爆倉訂單 |
| 交易對爆倉歷史 | 按週期彙總的爆倉金額,可查更長歷史 |
| 幣種交易所爆倉列表 | 最近一段時間各交易所的爆倉合計 |
| 支援的幣種 | 查詢 symbol 可填的幣種 |
常見問題
symbol 應該填幣種還是交易對?
填幣種,例如 BTC。傳 BTCUSDT 返回空陣列。返回結果裡的 symbol 才是各交易所的交易對寫法。
side 的 1 和 2 是什麼意思?
side 是爆倉訂單的成交方向,以整數返回:1 為買入,2 為賣出。請按成交方向理解,不要直接把它換算成多單爆倉或空單爆倉。
為什麼查不到 7 天以前的訂單?
本接口只提供過去 7 天內的爆倉訂單,start_time、end_time 都必須在最近 7 天內。
為什麼交易所名稱是大寫?
exchange_name 實際返回為大寫(如 BINANCE、HTX),與請求參數裡的 Binance 寫法不同,按名稱匹配時請先統一大小寫。
深入了解:爆倉訂單
什麼是爆倉訂單?
當合約倉位的虧損接近保證金時,交易所會以市價單強制平倉,這筆強平成交就是爆倉訂單。它記錄了強平發生的價格、規模和時間。
大額爆倉單有什麼參考意義?
單筆大額爆倉說明有重倉槓桿被清算,可能放大當下的價格波動;連續出現同方向的大額爆倉,往往對應一段急漲或急跌。
如何即時接收爆倉訂單?
除了輪詢本接口,也可以訂閱「爆倉訂單(WebSocket)」,由服務端即時推送。
