24h成交量—未平仓—24h爆仓$1.36B24h多空比—BTC市占—ETH市占—
App
语言 ▾
¥ CNY ▾
/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 纪元毫秒（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
选择一个端点，然后点击“发送请求”。响应、响应头和耗时将显示在这里。