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

1銘柄の清算サマリー

自社データ層：1銘柄の清算サマリー

GET/api/sd/liquidations

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
coinstring必須——銘柄シンボル。未指定の場合は400。エイリアス：`base`。 例: BTC

リクエスト例

curl -s "https://www.coinboss.com/api/sd/liquidations?coin=BTC"

レスポンスフィールド

フィールド表は実際のレスポンスから生成しているため、エンドポイントが返す内容をそのまま反映しています。パスでは、配列の要素をa[]、銘柄や取引所などの動的な名前をキーとするオブジェクトを{*}で表します。

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
coinstring—銘柄シンボル（大文字。例：BTC）。
nownumbermsレスポンスを生成した時点のサーバー時刻。
windowsobject—各ウィンドウの合計（キーは`1h`、`4h`、`12h`、`24h`など）。 動的キー: 1h,4h,12h,24h
windows.{*}object—ウィンドウごとの値。
windows.{*}.long_usdnumberUSD清算されたロングポジション。そのウィンドウをカバーするソースがない場合はnull。
windows.{*}.short_usdnumberUSD清算されたショートポジション。そのウィンドウをカバーするソースがない場合はnull。
windows.{*}.total_usdnumberUSDロング＋ショート。
windows.{*}.countnumber—清算注文の件数。
windows.{*}.long_pctnumber%合計に占めるロングの割合。
windows.{*}.max_orderobject—ウィンドウ内で最大の単一清算。
windows.{*}.max_order.exchangestring—取引所ID（小文字。例：`binance`）。
windows.{*}.max_order.symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
windows.{*}.max_order.sidestring—清算されたポジションのサイド（`long` = ロングが清算された）。
windows.{*}.max_order.pricenumber—建値通貨での直近価格（特記がない限りUSDまたはUSDT）。
windows.{*}.max_order.qtynumber—取引所が公表する注文サイズ（契約数またはコイン数）。
windows.{*}.max_order.contract_multipliernumber—`qty`を想定元本に換算する際に使用する、1契約あたりのコイン数。
windows.{*}.max_order.value_usdnumberUSD清算の想定元本：price × qty × contract multiplier。
windows.{*}.max_order.timestampnumbermsタイムスタンプ。
by_exchangeobject—各ウィンドウの取引所別内訳。 動的キー: 1h,4h,12h,24h
by_exchange.{*}array—取引所別の内訳。
by_exchange.{*}[]object—取引所別の内訳。
by_exchange.{*}[].exchangestring—取引所ID（小文字。例：`binance`）。
by_exchange.{*}[].long_usdnumberUSDロング側。
by_exchange.{*}[].short_usdnumberUSDショート側。
by_exchange.{*}[].total_usdnumberUSD合計。
by_exchange.{*}[].countnumber—清算注文の件数。
by_exchange.{*}[].share_pctnumber%合計に占める割合。
last_event_atnumbermsこの銘柄の直近の清算時刻。
last_event_age_snumbersそのイベントからの経過秒数。
sourcesarray—各清算フィードの状態：収集方法と最後にデータが届いた時刻。
sources[]object—データソース。
sources[].exchangestring—取引所ID（小文字。例：`binance`）。
sources[].viastring—収集方法（`ws`、`rest`など）。
sources[].statusstring—フィード自身のイベント時刻とハートビートから判定したフィードの状態。
sources[].feed_last_event_age_snumber|nullsイベントからの経過秒数。
sources[].ws_heartbeat_age_snumber|nullsイベントからの経過秒数。
sources[].judged_bystring—ステータスの判定に使用したタイムスタンプ。
sources[].coin_last_event_age_snumber|nullsイベントからの経過秒数。
sources[].min_event_usdnumberUSDフィードが配信する最小注文サイズ。これより小さい清算は、この取引所では確認できません。
sources[].notestring|null—備考。
sources[].node_heartbeat_age_snumbersイベントからの経過秒数。 省略される場合あり
sources[].pipeline_last_event_age_snumbersイベントからの経過秒数。 省略される場合あり
coverageobject—上記の数値に含まれるものと含まれないもの。他のソースと合計値を比較する前に、まずこの内容を比較してください。
coverage.collected_exchangesarray—公開の清算フィードがあり、CoinBossが収集している取引所。
coverage.collected_exchanges[]string—収集対象の取引所。
coverage.unavailablearray—算入できなかった取引所/契約の組み合わせ。それぞれ理由が付きます。0としてカウントされることはありません。
coverage.unavailable[]object—データが利用できない項目とその理由。0として報告されることはありません。
coverage.unavailable[].exchangestring—取引所ID（小文字。例：`binance`）。
coverage.unavailable[].reasonstring—理由コード。
methodobject—このレスポンスで使用した計算式を平文で記述したもの。
method.eventstring—清算イベント1件の定義に関する注記（平文）：取引所のストリームがプッシュした、または取引所の公開REST APIが返した清算注文1件を指します。
method.sidestring—清算されたポジションのサイド（`long` = ロングが清算された）。
method.value_usdstringUSD清算の想定元本：price × qty × contract multiplier。
method.dedupestring—重複排除に関する注記（平文）：イベントは取引所、シンボル、サイド、価格、金額、タイムスタンプの組み合わせで一意とし、取引所の注文IDが提供される場合はそれも加えます。
method.null_rulestring—収集されたイベントが1件もないウィンドウは0ではなくnullを返すこと、および公開フィードのない取引所の記載場所に関する注記（平文）。
method.binance_notestring—Binanceは1シンボルにつき1秒あたり最大1件の清算しかプッシュしないため、Binanceの合計は下限値であるという注意事項（平文）。
method.min_event_usdstringUSDフィードが配信する最小注文。

2026-11-11 23:00 UTCに4件の実レスポンスから生成。

レスポンス例

/api/sd/liquidations?coin=BTC · 実際のレスポンス（2026-11-13 03:57:52 UTCに取得）。 長い配列とマップは表示用に短縮しています：sourcesは11件; windowsは4件; by_exchangeは4件; by_exchange.{*}は10件; coverage.unavailableは10件; coverage.collected_exchangesは11件。

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542272606,
    • "windows": {
      • "1h": { … 6 },
      • "4h": { … 6 }
      },
    • "by_exchange": {
      • "1h": [ … 2 ],
      • "4h": [ … 2 ]
      },
    • "last_event_at": 1794542269523,
    • "last_event_age_s": 3,
    • "sources": [
      • { … 9 },
      • { … 9 }
      ],
    • "coverage": {
      • "collected_exchanges": [ … 8 ],
      • "unavailable": [ … 2 ]
      },
    • "method": {
      • "event": "one row per liquidation order pushed by the exchange (WS) or returned by its public REST; REST used to fill WS gaps (OKX/Gate/HTX)",
      • "side": "LONG = a long position was liquidated (forced sell); SHORT = a short position was liquidated (forced buy)",
      • "value_usd": "linear: filled qty × price; inverse: contracts × contract face value (USD)",
      • "dedupe": "unique (exchange, symbol, side, price, value_usd, timestamp) + exchange order id hash where provided",
      • "null_rule": "a window with no collected event returns null (shown as —), never 0; exchanges without a public feed are listed in coverage.unavailable",
      • "binance_note": "Binance WS pushes at most one liquidation per symbol per second (latest only) → Binance totals are a lower bound",
      • "min_event_usd": "collectors keep events above a per-exchange floor (sources[].min_event_usd: OKX/Bitget/HTX/Bitfinex/Deribit ≥ $100; Gate/Hyperliquid/Lighter ≥ $1; Binance/Bybit…"
      }
    }

検証済みサンプル

上の例に加えて、プローブは以下のパラメータでもこのエンドポイントを呼び出し、毎回スキーマを検証しています。

パラメータHTTPレイテンシ結果
coin=ETH20059 ms合格
coin=SOL20030 ms合格
coin=ARKM20017 ms合格
—4002 ms合格 想定どおりのエラーを返す

2026-11-13 03:57:52 UTCにチェック

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
15s
エッジマイクロキャッシュ
10s
更新頻度
リアルタイム（取引所のWebSocketプッシュ）。RESTポーリング：okxは15 sごと、gateは25 sごと、htxは5 minごと。hyperliquidノードの約定バッチは5 sごとに取り込み
ウィンドウ
ローリングウィンドウ：1 h、4 h、12 h、24 h
データソース
11取引所（binance、okx、bybit、gate、bitget、htxなど）の公開清算フィードから自社で収集した清算注文です。Hyperliquidの清算は、自社運用のHyperliquidノードの約定データから取得しています。
取引所カバレッジ
コレクターが稼働中の11取引所（binance USDT-M + COIN-M、okx、bybitのリニア + インバース、gateのUSDT + BTC決済、bitget、htx、hyperliquid、aster、lighter、bitfinex、deribit）。暗号資産のみが対象です（トークン化株式/指数/コモディティ/為替の契約は、別の伝統金融データセットに振り分けられます）。binanceは1シンボルにつき1秒あたり最大1件の清算しかプッシュしないため、その合計は下限値です。保存対象となる最小イベントサイズ：okx / bitget / htx / bitfinex / deribit / binance COIN-Mは100 USD、gate / hyperliquid / lighterは1 USD、binance USDT-M / bybit / asterは下限なし
単位
USD notional (price x quantity) per liquidation order; timestamps in Unix ms; side LONG = long position liquidated, SHORT = short position liquidated; max_order price normalized for multiplier contracts
算出方法
per window: long_usd, short_usd, total_usd = SUM(value_usd), count; by_exchange breakdown; largest single order
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版
提供開始
2026-11-11

ライブステータス

利用可能2026-11-13 03:57:52 UTCにチェックHTTP 200853 msスキーマ一致最新データポイントは3s前

可用性（過去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/sd/liquidations利用可能
パラメータ

string — Coin symbol; 400 when missing. Alias: `base`.

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