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

清算マップ

清算マップ（価格水準とレバレッジごとの推定清算規模）

GET/api/liq-map

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
symbolstring任意BTC—銘柄シンボル。データがない場合は404。 例: BTC
rangestring任意1d1d, 7d時間ウィンドウ。 例: 1d

リクエスト例

curl -s "https://www.coinboss.com/api/liq-map?symbol=BTC&range=1d"

レスポンスフィールド

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

フィールド型単位説明
symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
rangestring—リクエストされたウィンドウ。
updatedAtnumbermsデータが最後に更新された時刻。
currentPricenumber—現在価格。
binWidthnumberUSD1ビンの価格幅：価格軸は`currentPrice`を中心に±10 %（`1d`）または±18 %（`7d`）の範囲で、200ビンに分割されます。
leveragesarray—モデルがポジションを振り分けるレバレッジティア（昇順：10、25、50、100）。
leverages[]numberx1ティアのレバレッジ倍率。`bins[].tiers`内のキーとして使用されます。
binsarray—マップの200の価格ビン（価格の昇順）。モデル推定値であり、取引所のデータではありません。
bins[]object—1つの価格ビン：中央の`price`、`side`（現在価格より下は`long`、現在価格以上は`short`）、レバレッジ別の`tiers`とその`total`。
bins[].pricenumber—建値通貨での直近価格（特記がない限りUSDまたはUSDT）。
bins[].sidestring—`long` / `short`または`buy` / `sell`。
bins[].tiersobject—サイズ別のティア。
bins[].tiers.10numberUSDこの価格ビンにおける、10倍レバレッジで建てられたポジションに由来するモデル上の清算想定元本。金額がゼロの場合、キーは存在しません。 省略される場合あり
bins[].totalnumber—合計。
bins[].tiers.25numberUSDこの価格ビンにおける、25倍レバレッジで建てられたポジションに由来するモデル上の清算想定元本。金額がゼロの場合、キーは存在しません。 省略される場合あり
cumarray—`bins`とインデックスが1対1で対応する累積曲線。
cum[]numberUSD現在価格からこのビンまでに累積したモデル上の清算想定元本（下側のビンは下方向、上側のビンは上方向に累積）。
maxBinnumberUSDマップ内で最大の`bins[].total`。チャート軸のスケーリングに使用できます。
totalLongnumber—ロング合計。
totalShortnumber—ショート合計。
actualLiq24hnumberUSD直近24時間にその銘柄で実際に清算された想定元本（ロング + ショート、記録された清算注文）。モデルとの比較用です。

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

レスポンス例

/api/liq-map?symbol=BTC&range=1d · 実際のレスポンス（2026-11-13 03:58:05 UTCに取得）。 長い配列とマップは表示用に短縮しています：cumは200件; binsは200件。

  • {
    • "symbol": "BTC",
    • "range": "1d",
    • "updatedAt": 1794542191146,
    • "currentPrice": 68700.4,
    • "binWidth": 68.7004,
    • "leverages": [
      • 10,
      • 25,
      • 50,
      • 100
      ],
    • "bins": [
      • { … 4 },
      • { … 4 }
      ],
    • "cum": [
      • 182455131,
      • 182455131,
      • 182455131,
      • 182455131,
      • 182455131,
      • 162968077,
      • 162968077,
      • 162968077
      ],
    • "maxBin": 23159382,
    • "totalLong": 182455131,
    • "totalShort": 242009514,
    • "actualLiq24h": 784759171
    }

検証済みサンプル

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

パラメータHTTPレイテンシ結果
range=1d&symbol=ETH2003 ms合格
range=1d&symbol=SOL2002 ms合格

2026-11-13 03:58:05 UTCにチェック

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
60s
エッジマイクロキャッシュ
10s
更新頻度
上位100銘柄は5 minごと。101〜300位の銘柄は、時間をずらした5つのバッチで更新されます（約25 minごと）
ウィンドウ
rangeパラメータ：1d | 7d（ポジションが直近1日または7日間に建てられたと仮定）。最新のモデルスナップショット
データソース
CoinBoss自社の先物1時間足（binance、フォールバックはokx）、集計建玉の履歴、収集した清算データから自社で算出したモデル推定値です。
取引所カバレッジ
先物の想定元本ベースの出来高で順位付けした最大300の暗号資産銘柄。過去7日間に30件以上の清算イベントがあることが条件です。トークン化株式、コモディティ、為替、指数は除外されます。推定値はモデルの出力であり、取引所が報告する清算水準ではありません
単位
estimated liquidation notional in USD per price level; prices in USD; timestamps in Unix ms
算出方法
each 1 h candle opens notional proportional to volume x close (boosted by OI increase), spread over leverage tiers; long liq price ~ P x (1 - 1/L + MMR), short ~ P x (1 + 1/L - MMR); levels swept by later candles are cleared; output = cumulative long/short liquidation notional by price and leverage tier
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版

ライブステータス

利用可能2026-11-13 03:58:05 UTCにチェックHTTP 2001 msスキーマ一致最新データポイントは2m前

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

string · デフォルト BTC — Coin symbol; 404 when no data.

string · デフォルト 1d — Time window.

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