24h成交量—未平倉—24h爆倉$1.36B24h多空比—BTC市佔—ETH市佔—
App
語言 ▾
NT$ TWD ▾
/api/liquidation-events
GET可用

最大爆倉日（Top 10）

單日爆倉總額前 10 名：第三方歷史基線 + CoinBoss 自採記錄

GET/api/liquidation-events
榜單由兩類列合併而成，以 `source` 區分。`historical_baseline` 列來自第三方公開歷史資料，按原樣保留，不重新計算。`coinboss` 列是 CoinBoss 從交易所資料流採集的強平單按 UTC 自然日彙總的總額；只有當某日總額大於當時榜單第 10 名時才會入榜。

請求

此端點不接受任何參數。

請求範例

curl -s "https://www.coinboss.com/api/liquidation-events"

回應欄位

欄位表由真實回應產生，因此列出的正是端點實際回傳的內容。路徑中的 a[] 代表陣列元素，{*} 代表以動態名稱（例如幣種或交易所）為鍵的物件。

欄位型別單位說明
successboolean—請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。
countnumber—列數。
dataarray—回應主體資料。
data[]object—回應主體資料。
data[].rank_nonumber—在榜單中的名次，1 = `total_usd` 最大。榜單共 10 列。
data[].event_datestring—事件所在的自然日，格式為 `YYYY-MM-DD`。`coinboss` 列為 UTC 自然日。
data[].amount_usdnumberUSD與 `total_usd` 相同；為相容既有呼叫方而保留。
data[].total_usdnumberUSD當日爆倉名義總額；榜單按該欄位排序。`coinboss` 列為 `long_usd` + `short_usd`；基線列為資料記錄的數值。
data[].amount_displaystring—`total_usd` 的顯示用格式，例如 `$3.26B`。基線列沿用資料記錄的文字。
data[].long_usdnumberUSD多單爆倉金額。
data[].short_usdnumberUSD空單爆倉金額。
data[].liquidated_tradersstring|null—當日被爆倉的交易者人數（照錄第三方資料中的顯示文字，該資料未說明統計口徑）；`coinboss` 列為 null：CoinBoss 無法統計人數，改為提供 `liquidation_count` 與 `account_count`。
data[].btc_amplitudestring(decimal)|null—當日 BTC 日內振幅（百分比，照錄第三方資料中的顯示文字，該資料未說明價格來源與公式，因此不能與 `btc_range_pct` 直接比較）；`coinboss` 列為 null。
data[].event_zhstring|null—第三方資料隨記錄附帶的中文備註；資料中沒有備註時以及所有 `coinboss` 列均為 null。CoinBoss 不判定事件原因。
data[].sourcestring—該列的來源：`historical_baseline`（第三方公開歷史資料，按原樣保留）或 `coinboss`（CoinBoss 採集器的單日彙總）。
data[].basisstring—數值的取得方式：`third_party_public_history` 或 `coinboss_utc_daily_total`。
data[].updated_atnumber|nullmsCoinBoss 將該列加入榜單的時間；基線列為 null。
data[].liquidation_countnumber|null—CoinBoss 在該 UTC 自然日採集到的爆倉事件數（強平單或強平成交記錄），已去重。統計的是事件，不是人數，也不是帳戶數。基線列為 null。
data[].liquidation_count_metaobject—`liquidation_count` 的取得方式：品質、來源、時間窗與涵蓋範圍。
data[].liquidation_count_meta.kindstring—該數字統計的對象：`liquidation_events`（爆倉事件）。
data[].liquidation_count_meta.qualitystring—數值的可用性：`OK`、`PARTIAL`（只涵蓋部分市場，見 `coverage`）或 `UNAVAILABLE`（數值為 null）。
data[].liquidation_count_meta.reasonstring|null—數值不可用的原因，例如 `baseline_row_third_party_record`、`breakdown_not_recorded`、`no_account_identifier`；有數值時為 null。
data[].liquidation_count_meta.sourcestring|null—數值的來源：`coinboss_collectors`；數值不可用時為 null。
data[].liquidation_count_meta.source_atnumber|nullmsCoinBoss 記錄（凍結）該計數的時間；數值不可用時為 null。
data[].liquidation_count_meta.windowobject—數值涵蓋的時間窗。
data[].liquidation_count_meta.window.fromstring—時間窗起點（含），ISO 8601。
data[].liquidation_count_meta.window.tostring—時間窗終點（不含），ISO 8601。
data[].liquidation_count_meta.window.timezonestring—時間窗所用時區；恆為 `UTC`。
data[].liquidation_count_meta.coverageobject|null—數值涵蓋了哪些交易所和記錄；數值不可用時為 null。
data[].account_countnumber|null—該 UTC 自然日去重後的被爆倉帳戶數，只統計資料帶帳戶標識的交易所（目前為 Hyperliquid 的錢包地址）。除非 `account_count_meta.coverage.market_wide` 為 `true`，否則不是全市場數字；一個人也可能持有多個帳戶。基線列、以及沒有任何交易所提供帳戶標識時為 null。
data[].account_count_metaobject—`account_count` 的取得方式：品質、來源、時間窗與涵蓋範圍。
data[].account_count_meta.kindstring—該數字統計的對象：`unique_accounts`（去重帳戶）。
data[].account_count_meta.qualitystring—數值的可用性：`OK`、`PARTIAL`（只涵蓋部分市場，見 `coverage`）或 `UNAVAILABLE`（數值為 null）。
data[].account_count_meta.reasonstring|null—數值不可用的原因，例如 `baseline_row_third_party_record`、`breakdown_not_recorded`、`no_account_identifier`；有數值時為 null。
data[].account_count_meta.sourcestring|null—數值的來源：`coinboss_collectors`；數值不可用時為 null。
data[].account_count_meta.source_atnumber|nullmsCoinBoss 記錄（凍結）該計數的時間；數值不可用時為 null。
data[].account_count_meta.windowobject—數值涵蓋的時間窗。
data[].account_count_meta.window.fromstring—時間窗起點（含），ISO 8601。
data[].account_count_meta.window.tostring—時間窗終點（不含），ISO 8601。
data[].account_count_meta.window.timezonestring—時間窗所用時區；恆為 `UTC`。
data[].account_count_meta.coverageobject|null—數值涵蓋了哪些交易所和記錄；數值不可用時為 null。
data[].btc_highnumberUSD該 UTC 自然日的 BTC 現貨最高價：Binance（BTC/USDT）、Coinbase（BTC/USD）、Kraken（BTC/USD）三家當日最高價的中位數。三家的日K未全部定稿時為 null。
data[].btc_lownumberUSD該 UTC 自然日的 BTC 現貨最低價：Binance（BTC/USDT）、Coinbase（BTC/USD）、Kraken（BTC/USD）三家當日最低價的中位數。三家的日K未全部定稿時為 null。
data[].btc_rangenumberUSD該 UTC 自然日的 BTC 絕對振幅：`btc_high` − `btc_low`。
data[].btc_range_pctnumber%該 UTC 自然日的 BTC 振幅率（相對最低價）：(`btc_high` − `btc_low`) / `btc_low` × 100。
data[].btc_range_metaobject—BTC 最高價、最低價與振幅的取得方式：品質、來源、時間窗以及各交易所的價格。
data[].btc_range_meta.qualitystring—BTC 欄位的可用性：`OK` 或 `UNAVAILABLE`（四個 BTC 欄位均為 null）。
data[].btc_range_meta.reasonnull—BTC 欄位不可用的原因：`incomplete_venues`、`daily_candle_not_final`、`utc_day_not_closed` 或 `price_source_error`；有數值時為 null。
data[].btc_range_meta.sourcestring—價格來源：`coinboss_spot_composite`，由 CoinBoss 自行採集的三家交易所現貨日K合成。
data[].btc_range_meta.methodstring—計算方法：三家交易所當日最高價取中位數，當日最低價取中位數。
data[].btc_range_meta.price_typestring—所用價格的類型：`spot`（現貨）。
data[].btc_range_meta.unitstring—BTC 價格欄位的單位：`USD`。
data[].btc_range_meta.source_atnumberms所用日K的收盤時間（該 UTC 自然日結束時刻）；BTC 欄位不可用時為 null。
data[].btc_range_meta.windowobject—數值涵蓋的時間窗。
data[].btc_range_meta.window.fromstring—時間窗起點（含），ISO 8601。
data[].btc_range_meta.window.tostring—時間窗終點（不含），ISO 8601。
data[].btc_range_meta.window.timezonestring—時間窗所用時區；恆為 `UTC`。
data[].btc_range_meta.coverageobject—計算所需的交易所，以及各自的當日最高價與最低價。
data[].btc_range_meta.coverage.venues_requirednumber—計算所需的交易所數量（3）。
data[].btc_range_meta.coverage.venues_availablenumber—該日有日K的交易所數量。
data[].btc_range_meta.coverage.venuesarray—各交易所及其價格。
data[].btc_range_meta.coverage.venues[]object—一家交易所。
data[].btc_range_meta.coverage.venues[].exchangestring—交易所 ID。
data[].btc_range_meta.coverage.venues[].pairstring—日K對應的交易對。
data[].btc_range_meta.coverage.venues[].marketstring—市場類型：`spot`（現貨）。
data[].btc_range_meta.coverage.venues[].highnumber—該交易所的當日最高價，以 `pair` 的計價貨幣計；沒有該日K時為 null。
data[].btc_range_meta.coverage.venues[].lownumber—該交易所的當日最低價，以 `pair` 的計價貨幣計；沒有該日K時為 null。
data[].btc_range_meta.coverage.venues[].finalboolean—日K已定稿（該交易所的下一根日K已入庫）時為 `true`；沒有該日K時為 null。
data[].btc_range_meta.coverage.high_venuestring—當日最高價恰為中位數（即等於 `btc_high`）的交易所。
data[].btc_range_meta.coverage.low_venuestring—當日最低價恰為中位數（即等於 `btc_low`）的交易所。
data[].liquidation_count_meta.coverage.exchange_countnumber—當日至少有一筆爆倉事件的交易所數量。 可能不存在
data[].liquidation_count_meta.coverage.exchangesarray—這些交易所。 可能不存在
data[].liquidation_count_meta.coverage.exchanges[]string—交易所 ID。
data[].liquidation_count_meta.coverage.dedup_keystring—用於識別同一筆爆倉事件的欄位；鍵相同的記錄只計一次。 可能不存在
data[].liquidation_count_meta.coverage.raw_rowsnumber—去重前採集到的記錄數。 可能不存在
data[].liquidation_count_meta.coverage.duplicates_removednumber—被剔除的重複記錄數。 可能不存在
data[].liquidation_count_meta.coverage.by_exchangearray—該計數按交易所的拆分；沒有記錄分交易所快照時為 null。 可能不存在
data[].liquidation_count_meta.coverage.by_exchange[]object—一家交易所。
data[].liquidation_count_meta.coverage.by_exchange[].exchangestring—交易所 ID。
data[].liquidation_count_meta.coverage.by_exchange[].liquidation_countnumber—該交易所的爆倉事件數。
data[].liquidation_count_meta.coverage.by_exchange[].total_usdnumberUSD該交易所的爆倉名義金額。
data[].account_count_meta.coverage.market_wideboolean—只有當日彙總中的每家交易所、每筆事件都帶帳戶標識時才為 `true`。 可能不存在
data[].account_count_meta.coverage.exchange_countnumber—資料帶帳戶標識的交易所數量。 可能不存在
data[].account_count_meta.coverage.exchangesarray—這些交易所。 可能不存在
data[].account_count_meta.coverage.exchanges[]string—交易所 ID。
data[].account_count_meta.coverage.exchanges_totalnumber—當日彙總包含的交易所數量。 可能不存在
data[].account_count_meta.coverage.exchanges_without_account_idarray—當日彙總中資料不帶帳戶標識的交易所；它們的爆倉不計入 `account_count`。 可能不存在
data[].account_count_meta.coverage.exchanges_without_account_id[]string—交易所 ID。
data[].account_count_meta.coverage.by_exchangearray—`account_count` 按交易所的拆分。 可能不存在
data[].account_count_meta.coverage.by_exchange[]object—一家交易所。
data[].account_count_meta.coverage.by_exchange[].exchangestring—交易所 ID。
data[].account_count_meta.coverage.by_exchange[].account_countnumber—該交易所去重後的被爆倉帳戶數。
data[].account_count_meta.coverage.by_exchange[].eventsnumber—該交易所帶帳戶標識的爆倉事件數。
data[].account_count_meta.coverage.by_exchange[].usdnumberUSD這些事件的名義金額。
data[].account_count_meta.coverage.dedup_keystring—用於識別同一個帳戶的欄位；同一個鍵在一個 UTC 自然日內只計一次。 可能不存在
data[].account_count_meta.coverage.events_coverednumber—帶帳戶標識的爆倉事件數。 可能不存在
data[].account_count_meta.coverage.events_totalnumber—當日全部爆倉事件數（`liquidation_count`）。 可能不存在
data[].account_count_meta.coverage.events_share_pctnumber%`events_covered` / `events_total` × 100。 可能不存在
data[].account_count_meta.coverage.usd_coverednumberUSD帶帳戶標識的事件的名義金額。 可能不存在
data[].account_count_meta.coverage.usd_totalnumberUSD當日名義總額（`total_usd`）。 可能不存在
data[].account_count_meta.coverage.usd_share_pctnumber%`usd_covered` / `usd_total` × 100。 可能不存在
threshold_usdnumberUSD第 10 列的 `total_usd`。新的 CoinBoss 單日總額只有大於該值時才會入榜。
coverageobject—已納入與缺少的項目。
coverage.rankingstring—榜單的排序規則。
coverage.baselineobject—
coverage.baseline.sourcestring—基線列的來源。
coverage.baseline.rows_in_listnumber—回傳的 10 列中基線列的數量。
coverage.baseline.frozenboolean—恆為 `true`：基線列不會被重新計算。
coverage.baseline.checksum_okboolean—儲存的基線列與鎖定的參考副本逐位元組一致時為 `true`。
coverage.baseline.notestring—基線列的文字說明。
coverage.coinbossobject—
coverage.coinboss.sourcestring—CoinBoss 列的來源。
coverage.coinboss.basisstring—CoinBoss 列的彙總口徑。
coverage.coinboss.rows_in_listnumber—回傳的 10 列中 CoinBoss 列的數量。
coverage.coinboss.fromstring—榜單內 CoinBoss 列中最早的 `event_date`；沒有 CoinBoss 列時為 null。
coverage.coinboss.notestring—CoinBoss 列及入榜規則的文字說明。
coverage.metricsobject—計數欄位與 BTC 欄位的口徑定義。
coverage.metrics.people_countobject—爆倉人數的提供狀態。
coverage.metrics.people_count.qualitystring—恆為 `UNAVAILABLE`：CoinBoss 不發布爆倉人數。
coverage.metrics.people_count.notestring—人數為何不可得的文字說明。
coverage.metrics.liquidation_countobject—`data[].liquidation_count` 的口徑定義。
coverage.metrics.liquidation_count.kindstring—該數字統計的對象：`liquidation_events`（爆倉事件）。
coverage.metrics.liquidation_count.rowsstring—帶有該欄位的列：`coinboss` 或 `all`。
coverage.metrics.liquidation_count.definitionstring—文字定義。
coverage.metrics.liquidation_count.dedup_keystring—用於識別同一筆爆倉事件的欄位；鍵相同的記錄只計一次。
coverage.metrics.liquidation_count.limitsstring—該數值的已知侷限。
coverage.metrics.account_countobject—`data[].account_count` 的口徑定義。
coverage.metrics.account_count.kindstring—該數字統計的對象：`unique_accounts`（去重帳戶）。
coverage.metrics.account_count.rowsstring—帶有該欄位的列：`coinboss` 或 `all`。
coverage.metrics.account_count.definitionstring—文字定義。
coverage.metrics.account_count.dedup_keystring—用於識別同一個帳戶的欄位；同一個鍵在一個 UTC 自然日內只計一次。
coverage.metrics.btc_rangeobject—`data[].btc_high`、`btc_low`、`btc_range`、`btc_range_pct` 的口徑定義。
coverage.metrics.btc_range.sourcestring—價格來源：`coinboss_spot_composite`，由 CoinBoss 自行採集的三家交易所現貨日K合成。
coverage.metrics.btc_range.methodstring—計算方法：三家交易所當日最高價取中位數，當日最低價取中位數。
coverage.metrics.btc_range.price_typestring—所用價格的類型：`spot`（現貨）。
coverage.metrics.btc_range.unitstring—BTC 價格欄位的單位：`USD`。
coverage.metrics.btc_range.windowstring—價格所用時間窗的文字說明。
coverage.metrics.btc_range.venuesarray—計算所需的三家現貨交易所。
coverage.metrics.btc_range.venues[]object—一家交易所。
coverage.metrics.btc_range.venues[].exchangestring—交易所 ID。
coverage.metrics.btc_range.venues[].pairstring—日K對應的交易對。
coverage.metrics.btc_range.venues[].marketstring—市場類型：`spot`（現貨）。
coverage.metrics.btc_range.definitionstring—文字定義。
coverage.metrics.btc_range.limitsstring—該數值的已知侷限。
coverage.metrics.btc_range.rowsstring—帶有該欄位的列：`coinboss` 或 `all`。

產生於 2026-11-12 10:27 UTC，依據 1 筆真實回應。

回應範例

/api/liquidation-events · 真實回應，擷取於 2026-11-13 03:57:53 UTC。 較長的陣列與對應表已截短顯示：data 原有 10 個項目; coverage.metrics.btc_range.venues 原有 3 個項目; data[].btc_range_meta.coverage.venues 原有 3 個項目。

  • {
    • "success": true,
    • "count": 10,
    • "data": [
      • { … 22 },
      • { … 22 }
      ],
    • "threshold_usd": 2768000000,
    • "coverage": {
      • "ranking": "top10_by_total_usd_desc",
      • "baseline": { … 5 },
      • "coinboss": { … 5 },
      • "metrics": { … 4 }
      }
    }

詳細資訊

身分驗證
無。公開端點。
速率限制
每個 IP 每分鐘 1200 次請求
伺服器快取
5m
邊緣微快取
10s
更新頻率
每日 02:30 UTC
時間視窗
基線列涵蓋全部歷史；CoinBoss 列自 2026-08-19 起至昨日（UTC）。
資料來源
基線列：第三方公開歷史資料（靜態，不再重新整理）。CoinBoss 列：CoinBoss 自行從交易所資料流採集的強平記錄，去重後按 UTC 自然日加總。BTC 價格（所有列）：CoinBoss 自行採集的 Binance（BTC/USDT）、Coinbase（BTC/USD）、Kraken（BTC/USD）現貨日K（UTC）。
交易所覆蓋範圍
共 10 列。基線列沿用第三方資料記錄的數值（`liquidated_traders`、`btc_amplitude`、`event_zh`）。CoinBoss 不發布爆倉人數：交易所資料流無法識別到人。`liquidation_count` 與 `account_count` 只有 CoinBoss 列才有，且 `account_count` 只涵蓋資料帶帳戶標識的交易所（目前為 Hyperliquid）。`btc_high`、`btc_low`、`btc_range`、`btc_range_pct` 對每一列都計算；三家現貨交易所的日K未全部定稿時為 null。
排序
按 total_usd 降冪（rank_no 升冪）
單位
total_usd / amount_usd / long_usd / short_usd / threshold_usd / btc_high / btc_low / btc_range 單位為 USD；btc_range_pct 為百分比；liquidation_count 為事件數；account_count 為帳戶數；event_date 為日曆日期；amount_display、liquidated_traders、btc_amplitude 為顯示用字串
計算方法
CoinBoss 列：採集到的強平單去重後按 UTC 自然日 SUM(value_usd)。新的一天只有在 total_usd 大於第 10 名的 total_usd 時才入榜；隨後全部列按 total_usd 排序並回傳前 10 列。基線列不重新計算。BTC：btc_high / btc_low = 三家現貨交易所當日最高價 / 最低價的中位數；btc_range = btc_high − btc_low；btc_range_pct = (btc_high − btc_low) / btc_low × 100。
時間戳記
Unix epoch 毫秒（UTC），除非欄位說明另有註明
回應格式
json
穩定性
穩定版

即時狀態

可用檢查於 2026-11-13 03:57:53 UTCHTTP 2001 ms結構描述相符

近 30 天可用率

410 次檢查中有 100% 通過

錯誤

所有端點的失敗回應都採用同一種結構。完整清單請見錯誤頁面。 錯誤與速率限制 →

錯誤碼HTTP意義處理方式
INVALID_PARAM400缺少必填參數，或某個值不被接受。已知時，`param` 會指出是哪個參數。請勿原樣重試；請修正請求。
UNAUTHORIZED401已送出 `CB-API-KEY` 標頭，但金鑰未知或已撤銷。公開資料不需要金鑰——請移除該標頭或改用有效的金鑰。請勿原樣重試。
FORBIDDEN403此路由不屬於公開 API（內部或僅限帳戶使用）。請勿重試。
NOT_FOUND404未知的路由，或所請求的幣種／交易所／基金不存在。請勿重試；請對照目錄檢查路徑與識別碼。
RATE_LIMITED429請求數超過每分鐘上限。`Retry-After` 會指出需等待的秒數。等待 `Retry-After` 指定的時間後，再以退避策略重試。
INTERNAL500非預期的伺服器錯誤。訊息刻意保持籠統；回報時請附上 `request_id`。幾秒後重試一次；若問題持續，請附上請求 ID 回報。
UPSTREAM_FAILED503此端點背後的資料來源未及時回應。不會以過期或替代的數字代替回傳。以退避策略重試；並查看狀態頁面。
UNAVAILABLE501 / 503資料集暫時尚未就緒（快取預熱中），或此端點目前尚無合法的公開來源。稍後重試；目錄會標示出設計上即無法使用的端點。
REQUEST_FAILED200部分舊版端點會以 HTTP 200 回應但帶有 `success: false`。請務必檢查 `success`，而不只是 HTTP 狀態碼。視訊息而定；請當作失敗的請求處理。

試用

GET/api/liquidation-events可用
參數

無參數。

請求 URLhttps://www.coinboss.com/api/liquidation-events
選擇一個端點並按下「送出請求」。回應內容、標頭與耗時會顯示在這裡。