24h出来高—建玉—24h清算$1.36B24hロング/ショート—BTCドミナンス—ETHドミナンス—
アプリ
言語 ▾
¥ JPY ▾
/api/liquidation-events
GET利用可能

清算額が最大の日（トップ10）

日次清算総額のトップ10：第三者の過去ベースラインとCoinBossの自社記録

GET/api/liquidation-events
The list merges two kinds of rows, told apart by `source`. `historical_baseline` rows come from third-party public historical records; they are kept as recorded and are never recalculated. `coinboss` rows are UTC daily totals of liquidation orders CoinBoss collected from exchange feeds; a day is added only when its total is greater than the 10th place of the list at that time.

リクエスト

このエンドポイントにパラメータはありません。

リクエスト例

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—Position in the list, 1 = largest `total_usd`. The list holds 10 rows.
data[].event_datestring—Calendar day of the event, formatted `YYYY-MM-DD`. For `coinboss` rows it is a UTC day.
data[].amount_usdnumberUSDSame value as `total_usd`; kept for existing clients.
data[].total_usdnumberUSDTotal notional liquidated on that day; the list is sorted by this field. `coinboss` rows: `long_usd` + `short_usd`. Baseline rows: the figure as recorded.
data[].amount_displaystring—`total_usd` pre-formatted for display, e.g. `$3.26B`. Baseline rows carry the text as recorded.
data[].long_usdnumberUSD清算されたロング。
data[].short_usdnumberUSD清算されたショート。
data[].liquidated_tradersstring|null—Number of traders liquidated that day, as display text copied from the third-party record; its definition is not stated by that record. null for `coinboss` rows: CoinBoss cannot count people and reports `liquidation_count` and `account_count` instead.
data[].btc_amplitudestring(decimal)|null—BTC intraday price range of that day in percent, as display text copied from the third-party record; its price source and formula are not stated by that record, so it is not comparable with `btc_range_pct`. null for `coinboss` rows.
data[].event_zhstring|null—Note attached to the third-party record, in Chinese; null when the record has none and for all `coinboss` rows. CoinBoss does not assign causes.
data[].sourcestring—Origin of the row: `historical_baseline` (third-party public historical record, kept as recorded) or `coinboss` (daily total from CoinBoss collectors).
data[].basisstring—How the figure was obtained: `third_party_public_history` or `coinboss_utc_daily_total`.
data[].updated_atnumber|nullmsWhen CoinBoss added the row to the list; null for baseline rows.
data[].liquidation_countnumber|null—Number of liquidation events (liquidation orders or liquidation fills) CoinBoss collected on that UTC day, after de-duplication. It counts events, not people or accounts. null for baseline rows.
data[].liquidation_count_metaobject—How `liquidation_count` was obtained: quality, source, time window and coverage.
data[].liquidation_count_meta.kindstring—What the number counts: `liquidation_events`.
data[].liquidation_count_meta.qualitystring—Availability of the value: `OK`, `PARTIAL` (covers only part of the market, see `coverage`) or `UNAVAILABLE` (the value is null).
data[].liquidation_count_meta.reasonstring|null—Why the value is unavailable, for example `baseline_row_third_party_record`, `breakdown_not_recorded` or `no_account_identifier`; null when a value is present.
data[].liquidation_count_meta.sourcestring|null—Origin of the value: `coinboss_collectors`; null when the value is unavailable.
data[].liquidation_count_meta.source_atnumber|nullmsWhen CoinBoss recorded (froze) the count; null when the value is unavailable.
data[].liquidation_count_meta.windowobject—Time window the value covers.
data[].liquidation_count_meta.window.fromstring—Start of the window (inclusive), ISO 8601.
data[].liquidation_count_meta.window.tostring—End of the window (exclusive), ISO 8601.
data[].liquidation_count_meta.window.timezonestring—Time zone of the window; always `UTC`.
data[].liquidation_count_meta.coverageobject|null—Which exchanges and records the value covers; null when the value is unavailable.
data[].account_countnumber|null—Number of distinct liquidated accounts on that UTC day, counted only on exchanges whose data carries an account identifier (currently Hyperliquid wallet addresses). It is not a market-wide figure unless `account_count_meta.coverage.market_wide` is `true`, and one person can hold several accounts. null for baseline rows and when no exchange exposes an identifier.
data[].account_count_metaobject—How `account_count` was obtained: quality, source, time window and coverage.
data[].account_count_meta.kindstring—What the number counts: `unique_accounts`.
data[].account_count_meta.qualitystring—Availability of the value: `OK`, `PARTIAL` (covers only part of the market, see `coverage`) or `UNAVAILABLE` (the value is null).
data[].account_count_meta.reasonstring|null—Why the value is unavailable, for example `baseline_row_third_party_record`, `breakdown_not_recorded` or `no_account_identifier`; null when a value is present.
data[].account_count_meta.sourcestring|null—Origin of the value: `coinboss_collectors`; null when the value is unavailable.
data[].account_count_meta.source_atnumber|nullmsWhen CoinBoss recorded (froze) the count; null when the value is unavailable.
data[].account_count_meta.windowobject—Time window the value covers.
data[].account_count_meta.window.fromstring—Start of the window (inclusive), ISO 8601.
data[].account_count_meta.window.tostring—End of the window (exclusive), ISO 8601.
data[].account_count_meta.window.timezonestring—Time zone of the window; always `UTC`.
data[].account_count_meta.coverageobject|null—Which exchanges and records the value covers; null when the value is unavailable.
data[].btc_highnumberUSDBTC spot high of that UTC day: median of the daily highs on Binance (BTC/USDT), Coinbase (BTC/USD) and Kraken (BTC/USD). null unless all three venues have a final daily candle.
data[].btc_lownumberUSDBTC spot low of that UTC day: median of the daily lows on Binance (BTC/USDT), Coinbase (BTC/USD) and Kraken (BTC/USD). null unless all three venues have a final daily candle.
data[].btc_rangenumberUSDAbsolute BTC price range of that UTC day: `btc_high` − `btc_low`.
data[].btc_range_pctnumber%BTC price range of that UTC day relative to the low: (`btc_high` − `btc_low`) / `btc_low` × 100.
data[].btc_range_metaobject—How the BTC high, low and range were obtained: quality, source, time window and the prices of each venue.
data[].btc_range_meta.qualitystring—Availability of the BTC fields: `OK` or `UNAVAILABLE` (the four BTC fields are null).
data[].btc_range_meta.reasonnull—Why the BTC fields are unavailable: `incomplete_venues`, `daily_candle_not_final`, `utc_day_not_closed` or `price_source_error`; null when values are present.
data[].btc_range_meta.sourcestring—Origin of the prices: `coinboss_spot_composite`, built from the spot daily candles CoinBoss collects from the three venues.
data[].btc_range_meta.methodstring—Calculation method: median of the three venues’ daily highs, and median of their daily lows.
data[].btc_range_meta.price_typestring—Kind of price used: `spot`.
data[].btc_range_meta.unitstring—Unit of the BTC price fields: `USD`.
data[].btc_range_meta.source_atnumbermsClose time of the daily candles used (end of the UTC day); null when the BTC fields are unavailable.
data[].btc_range_meta.windowobject—Time window the value covers.
data[].btc_range_meta.window.fromstring—Start of the window (inclusive), ISO 8601.
data[].btc_range_meta.window.tostring—End of the window (exclusive), ISO 8601.
data[].btc_range_meta.window.timezonestring—Time zone of the window; always `UTC`.
data[].btc_range_meta.coverageobject—The venues the calculation requires and the daily high and low of each.
data[].btc_range_meta.coverage.venues_requirednumber—Number of venues the calculation requires (3).
data[].btc_range_meta.coverage.venues_availablenumber—Number of venues that have a daily candle for that day.
data[].btc_range_meta.coverage.venuesarray—The venues and their prices.
data[].btc_range_meta.coverage.venues[]object—One venue.
data[].btc_range_meta.coverage.venues[].exchangestring—取引所ID。
data[].btc_range_meta.coverage.venues[].pairstring—Trading pair of the daily candle.
data[].btc_range_meta.coverage.venues[].marketstring—Market type: `spot`.
data[].btc_range_meta.coverage.venues[].highnumber—Daily high on this venue, in the quote currency of `pair`; null when the candle is missing.
data[].btc_range_meta.coverage.venues[].lownumber—Daily low on this venue, in the quote currency of `pair`; null when the candle is missing.
data[].btc_range_meta.coverage.venues[].finalboolean—`true` when the daily candle is final, i.e. the venue’s next daily candle has been stored; null when the candle is missing.
data[].btc_range_meta.coverage.high_venuestring—Venue whose daily high is the median, i.e. equals `btc_high`.
data[].btc_range_meta.coverage.low_venuestring—Venue whose daily low is the median, i.e. equals `btc_low`.
data[].liquidation_count_meta.coverage.exchange_countnumber—Number of exchanges with at least one liquidation event that day. 省略される場合あり
data[].liquidation_count_meta.coverage.exchangesarray—Those exchanges. 省略される場合あり
data[].liquidation_count_meta.coverage.exchanges[]string—取引所ID。
data[].liquidation_count_meta.coverage.dedup_keystring—Fields that identify one liquidation event; records with the same key are counted once. 省略される場合あり
data[].liquidation_count_meta.coverage.raw_rowsnumber—Number of collected records before de-duplication. 省略される場合あり
data[].liquidation_count_meta.coverage.duplicates_removednumber—Number of duplicate records dropped. 省略される場合あり
data[].liquidation_count_meta.coverage.by_exchangearray—Per-exchange split of the count; null when no per-exchange snapshot was recorded. 省略される場合あり
data[].liquidation_count_meta.coverage.by_exchange[]object—One exchange.
data[].liquidation_count_meta.coverage.by_exchange[].exchangestring—取引所ID。
data[].liquidation_count_meta.coverage.by_exchange[].liquidation_countnumber—Liquidation events on this exchange.
data[].liquidation_count_meta.coverage.by_exchange[].total_usdnumberUSDNotional liquidated on this exchange.
data[].account_count_meta.coverage.market_wideboolean—`true` only when every exchange in the day’s total exposes an account identifier for every event. 省略される場合あり
data[].account_count_meta.coverage.exchange_countnumber—Number of exchanges whose data carries an account identifier. 省略される場合あり
data[].account_count_meta.coverage.exchangesarray—Those exchanges. 省略される場合あり
data[].account_count_meta.coverage.exchanges[]string—取引所ID。
data[].account_count_meta.coverage.exchanges_totalnumber—Number of exchanges in the day’s total. 省略される場合あり
data[].account_count_meta.coverage.exchanges_without_account_idarray—Exchanges in the day’s total whose data carries no account identifier; their liquidations are not part of `account_count`. 省略される場合あり
data[].account_count_meta.coverage.exchanges_without_account_id[]string—取引所ID。
data[].account_count_meta.coverage.by_exchangearray—Per-exchange split of `account_count`. 省略される場合あり
data[].account_count_meta.coverage.by_exchange[]object—One exchange.
data[].account_count_meta.coverage.by_exchange[].exchangestring—取引所ID。
data[].account_count_meta.coverage.by_exchange[].account_countnumber—Distinct liquidated accounts on this exchange.
data[].account_count_meta.coverage.by_exchange[].eventsnumber—Liquidation events on this exchange that carry an account identifier.
data[].account_count_meta.coverage.by_exchange[].usdnumberUSDNotional of those events.
data[].account_count_meta.coverage.dedup_keystring—Fields that identify one account; the same key is counted once per UTC day. 省略される場合あり
data[].account_count_meta.coverage.events_coverednumber—Liquidation events that carry an account identifier. 省略される場合あり
data[].account_count_meta.coverage.events_totalnumber—All liquidation events of the day (`liquidation_count`). 省略される場合あり
data[].account_count_meta.coverage.events_share_pctnumber%`events_covered` / `events_total` × 100. 省略される場合あり
data[].account_count_meta.coverage.usd_coverednumberUSDNotional of the events that carry an account identifier. 省略される場合あり
data[].account_count_meta.coverage.usd_totalnumberUSDTotal notional of the day (`total_usd`). 省略される場合あり
data[].account_count_meta.coverage.usd_share_pctnumber%`usd_covered` / `usd_total` × 100. 省略される場合あり
threshold_usdnumberUSD`total_usd` of the 10th row. A new CoinBoss day is added only when its total is greater than this value.
coverageobject—含まれているものと欠けているもの。
coverage.rankingstring—Ordering rule of the list.
coverage.baselineobject—
coverage.baseline.sourcestring—Origin of the baseline rows.
coverage.baseline.rows_in_listnumber—Number of baseline rows among the 10 rows returned.
coverage.baseline.frozenboolean—Always `true`: baseline rows are never recalculated.
coverage.baseline.checksum_okboolean—`true` when the stored baseline rows are byte-identical to the locked reference copy.
coverage.baseline.notestring—Plain-language description of the baseline rows.
coverage.coinbossobject—
coverage.coinboss.sourcestring—Origin of the CoinBoss rows.
coverage.coinboss.basisstring—Aggregation basis of the CoinBoss rows.
coverage.coinboss.rows_in_listnumber—Number of CoinBoss rows among the 10 rows returned.
coverage.coinboss.fromstring—Earliest `event_date` among the CoinBoss rows in the list; null when there are none.
coverage.coinboss.notestring—Plain-language description of the CoinBoss rows and the admission rule.
coverage.metricsobject—Definitions of the count fields and the BTC fields.
coverage.metrics.people_countobject—Status of a liquidated-trader (people) count.
coverage.metrics.people_count.qualitystring—Always `UNAVAILABLE`: CoinBoss does not publish a people count.
coverage.metrics.people_count.notestring—Plain-language explanation of why a people count is not available.
coverage.metrics.liquidation_countobject—Definition of `data[].liquidation_count`.
coverage.metrics.liquidation_count.kindstring—What the number counts: `liquidation_events`.
coverage.metrics.liquidation_count.rowsstring—Rows that carry the field: `coinboss` or `all`.
coverage.metrics.liquidation_count.definitionstring—Plain-language definition.
coverage.metrics.liquidation_count.dedup_keystring—Fields that identify one liquidation event; records with the same key are counted once.
coverage.metrics.liquidation_count.limitsstring—Known limits of the figure.
coverage.metrics.account_countobject—Definition of `data[].account_count`.
coverage.metrics.account_count.kindstring—What the number counts: `unique_accounts`.
coverage.metrics.account_count.rowsstring—Rows that carry the field: `coinboss` or `all`.
coverage.metrics.account_count.definitionstring—Plain-language definition.
coverage.metrics.account_count.dedup_keystring—Fields that identify one account; the same key is counted once per UTC day.
coverage.metrics.btc_rangeobject—Definition of `data[].btc_high`, `btc_low`, `btc_range` and `btc_range_pct`.
coverage.metrics.btc_range.sourcestring—Origin of the prices: `coinboss_spot_composite`, built from the spot daily candles CoinBoss collects from the three venues.
coverage.metrics.btc_range.methodstring—Calculation method: median of the three venues’ daily highs, and median of their daily lows.
coverage.metrics.btc_range.price_typestring—Kind of price used: `spot`.
coverage.metrics.btc_range.unitstring—Unit of the BTC price fields: `USD`.
coverage.metrics.btc_range.windowstring—Time window of the prices, in words.
coverage.metrics.btc_range.venuesarray—The three spot venues the calculation requires.
coverage.metrics.btc_range.venues[]object—One venue.
coverage.metrics.btc_range.venues[].exchangestring—取引所ID。
coverage.metrics.btc_range.venues[].pairstring—Trading pair of the daily candle.
coverage.metrics.btc_range.venues[].marketstring—Market type: `spot`.
coverage.metrics.btc_range.definitionstring—Plain-language definition.
coverage.metrics.btc_range.limitsstring—Known limits of the figure.
coverage.metrics.btc_range.rowsstring—Rows that carry the field: `coinboss` or `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
ウィンドウ
All time for baseline rows; CoinBoss rows start on 2026-08-19 and run to yesterday (UTC).
データソース
Baseline rows: third-party public historical records (static, not refreshed). CoinBoss rows: CoinBoss's own liquidation records collected from exchange feeds, de-duplicated and summed per UTC day. BTC prices (all rows): spot daily candles (UTC) that CoinBoss collects from Binance (BTC/USDT), Coinbase (BTC/USD) and Kraken (BTC/USD).
取引所カバレッジ
10 rows. Baseline rows carry the third-party figures as recorded (`liquidated_traders`, `btc_amplitude`, `event_zh`). CoinBoss does not publish a liquidated-trader (people) count: exchange feeds do not identify people. `liquidation_count` and `account_count` exist for CoinBoss rows only, and `account_count` covers only exchanges whose data carries an account identifier (currently Hyperliquid). `btc_high`, `btc_low`, `btc_range` and `btc_range_pct` are computed for every row and are null unless all three spot venues have a final daily candle.
ソート
total_usd desc (rank_no asc)
単位
total_usd / amount_usd / long_usd / short_usd / threshold_usd / btc_high / btc_low / btc_range in USD; btc_range_pct in percent; liquidation_count in events; account_count in accounts; event_date as calendar date; amount_display, liquidated_traders, btc_amplitude are display strings
算出方法
CoinBoss rows: SUM(value_usd) of collected liquidation orders per UTC day after de-duplication. A new day is admitted when its total_usd is greater than the total_usd of rank 10. All rows are then sorted by total_usd and the first 10 are returned. Baseline rows are not recomputed. BTC: btc_high / btc_low = median of the daily high / low of the three spot venues; 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 UTCにチェックHTTP 2001 msスキーマ一致

可用性（過去30日間）

410回のチェック中100%が合格

エラー

失敗した呼び出しは、すべてのエンドポイントで共通の形式で返されます。一覧はエラーページにあります。 エラーとレート制限 →

コードHTTP意味対処方法
INVALID_PARAM400必須パラメータが不足しているか、値が受け付けられません。該当するパラメータが特定できる場合は、`param`にその名前が入ります。そのまま再試行せず、リクエストを修正してください。
UNAUTHORIZED401`CB-API-KEY`ヘッダーが送信されましたが、キーが不明か失効済みです。公開データにキーは不要です。ヘッダーを外すか、有効なキーを使用してください。そのまま再試行しないでください。
FORBIDDEN403このルートは公開APIに含まれません（内部用またはアカウント専用）。再試行しないでください。
NOT_FOUND404不明なルートであるか、リクエストされた銘柄 / 取引所 / ファンドが存在しません。再試行せず、パスと識別子をカタログと照合してください。
RATE_LIMITED429リクエスト数が1分あたりの上限を超えました。`Retry-After`に待機すべき秒数が示されます。`Retry-After`で示された時間だけ待ってから、バックオフ付きで再試行してください。
INTERNAL500予期しないサーバーエラーです。メッセージは意図的に汎用的な内容にしています。報告の際は`request_id`を引用してください。数秒後に1回だけ再試行してください。解消しない場合は、リクエストIDを添えて報告してください。
UPSTREAM_FAILED503このエンドポイントの背後にあるデータソースが時間内に応答しませんでした。鮮度切れの数値や代替の数値を代わりに返すことはありません。バックオフ付きで再試行し、ステータスページを確認してください。
UNAVAILABLE501 / 503データセットが一時的に準備できていない（キャッシュのウォームアップ中）か、このエンドポイントに適法な公開ソースがまだありません。時間をおいて再試行してください。仕様上利用できないエンドポイントは、カタログに明示されています。
REQUEST_FAILED200一部の古いエンドポイントは、HTTP 200で`success: false`を返します。HTTPステータスだけでなく、必ず`success`を確認してください。メッセージによって異なります。失敗したリクエストとして扱ってください。

試してみる

GET/api/liquidation-events利用可能
パラメータ

パラメータはありません。

リクエストURLhttps://www.coinboss.com/api/liquidation-events
エンドポイントを選択して「リクエストを送信」を押してください。レスポンス、ヘッダー、所要時間がここに表示されます。