24h出来高—建玉—24h清算$1.36B24hロング/ショート—BTCドミナンス—ETHドミナンス—
アプリ
言語 ▾
¥ JPY ▾
/api/sd/liquidity/history
GET一部FRESH

板の厚みの履歴

1銘柄について、1つの価格帯における買い板と売り板の厚みを集計した時系列です。対象は全カバー取引所または1取引所です。各データポイントには、含まれる契約数が示されます。

GET/api/sd/liquidity/history
部分的なカバレッジ. 収集は2026-11-11に開始したため、長い期間は順次埋まっていきます。欠損したバケットは補間されず、存在しません。2つのポイント間で`n_included`が変化した場合は、算入される契約の集合が変わったことを意味します。

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
coinstring必須——銘柄シンボル。大文字と小文字は区別しません（例：`BTC`）。値が未指定または不正な場合は400を返します。 例: BTC
marketstring任意perpperp, spot市場タイプ。無期限先物と現物の板を合算することはありません。
bandstring任意10.5, 1, 2仲値からの距離（%）。
rangestring任意24h24h, 7d, 30d遡及期間：24h（30分ごとのポイント）、7d（2時間ごとのポイント）、30d（6時間ごとのポイント）のいずれか。
exchangestring任意——この市場でカバーされている取引所IDを1つ指定します（例：`gate`）。デフォルト：全取引所。カバーされていない取引所を指定すると400を返します。

リクエスト例

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

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
schemastring—このレスポンスのスキーマID。既存フィールドの意味または型が変わった場合にのみ変更されます。
nownumbermsレスポンスを生成した時点のサーバー時刻。
coinstring—銘柄シンボル（大文字）。
marketstring—`perp`または`spot`。
band_pctnumber%選択された価格帯：仲値からの距離。
rangestring—適用された遡及期間。
exchangestring|null—取引所ID（小文字）。
interval_snumbersポイントの間隔。
pointsarray—系列のポイント（古い順）。
points[]object—系列のポイント（古い順）。
points[].tnumberms時間バケットの開始時刻。
points[].bid_depth_usdnumberUSD仲値から価格帯の下端までにある買い指値注文の想定元本。`complete`がfalseの場合は下限値です。
points[].ask_depth_usdnumberUSD仲値から価格帯の上端までにある売り指値注文の想定元本。`complete`がfalseの場合は下限値です。
points[].n_includednumber—板の厚みの合計に含まれる行数：鮮度内で、かつその価格帯について完全な行。板の厚みの値と併せて読んでください。
points[].n_rowsnumber—見つかった行数（鮮度切れの行を含む）。
points[].midnumberUSD(best bid + best ask) ÷ 2。1コインあたりの価格。
points[].uses_aggregated_bucketsboolean—算入された行に価格集約済みのバケットを使用したものがある場合はtrue。この場合、合計は下限値になります。
points_expectednumber—期間が完全な場合に含まれるポイント数。
first_tnumberms返された最初のポイントの時刻。
last_tnumberms返された最後のポイントの時刻。
exchange_pointsobject—各取引所が含まれるポイント数（キーは取引所ID）。 動的キー: deribit,aster,backpack,bitfinex,bitget,bitunix
exchange_points.{*}number—各取引所が含まれるポイント数（キーは取引所ID）。
coverageobject—数値に含まれるものと含まれないもの。他のソースと合計値を比較する前に、まずこの内容を比較してください。
coverage.included_exchangesarray—鮮度内のデータが算入されているソース。
coverage.included_exchanges[]string—鮮度内のデータが算入されているソース。
coverage.unavailablearray—算入できなかったソース。それぞれ理由が付きます。0としてカウントされることはありません。 この表の生成に使用したサンプルでは空
coverage.stale_excludedarray—最終更新が鮮度ウィンドウの外にあるため除外された行。 この表の生成に使用したサンプルでは空
methodobject—このレスポンスで使用した計算式を平文で記述したもの。フィールドごとに1エントリー。
method.bid_depth_usdstring—`bid_depth_usd`の計算式に関する注記（平文）。
method.ask_depth_usdstring—`ask_depth_usd`の計算式に関する注記（平文）。
method.completestring—`complete`の計算式に関する注記（平文）。
method.historystring—`history`の計算式に関する注記（平文）。
method.exchange_pointsstring—`exchange_points`の計算式に関する注記（平文）。
metaobject—このレスポンスのデータリネージと鮮度。
meta.schemastring—このレスポンスのスキーマID。既存フィールドの意味または型が変わった場合にのみ変更されます。
meta.sourcearray—データの収集元である上流の公開エンドポイント。
meta.source[]object—データの収集元である上流の公開エンドポイント。
meta.source[].exchangestring—取引所ID（小文字）。
meta.source[].marketstring—`perp`または`spot`。
meta.source[].endpointstring—コレクターが読み取るソースの公開エンドポイント（データリネージのために表示。クライアントが呼び出すことはありません）。
meta.observed_atnull—ソースがデータに付与したタイムスタンプ。
meta.received_atnumbermsCoinBossのコレクターがデータを受信した時刻。
meta.fetched_atnumbermsこのレスポンスが組み立てられた時刻。
meta.windowstring—数値が対象とする時間ウィンドウ。
meta.qualitystring—FRESH、PARTIAL、STALE、BROKEN、UNAVAILABLEのいずれか。データのタイムスタンプとカバレッジから判定します。
meta.is_staleboolean—データが鮮度ウィンドウより古い場合はtrue。
meta.cache_ttl_snumbersこのレスポンスのキャッシュ有効期間。
meta.fallbackstring—コレクターまたはソースに障害が発生した場合にエンドポイントが返す内容。
meta.collector_heartbeat_age_snumbersコレクターが稼働中であることを最後に報告してからの経過秒数。

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

レスポンス例

/api/sd/liquidity/history?coin=BTC · 実際のレスポンス（2026-11-13 04:02:45 UTCに取得）。 長い配列とマップは表示用に短縮しています：pointsは48件; meta.sourceは19件; exchange_pointsは19件; coverage.included_exchangesは19件。

  • {
    • "success": true,
    • "schema": "coinboss.sd.liquidity/1",
    • "now": 1794542565889,
    • "coin": "BTC",
    • "market": "perp",
    • "band_pct": 1,
    • "range": "24h",
    • "exchange": null,
    • "interval_s": 1800,
    • "points": [
      • { … 7 },
      • { … 7 }
      ],
    • "points_expected": 48,
    • "first_t": 1794457800000,
    • "last_t": 1794542400000,
    • "exchange_points": {
      • "deribit": 96,
      • "aster": 48
      },
    • "coverage": {
      • "included_exchanges": [ … 8 ],
      • "unavailable": [],
      • "stale_excluded": []
      },
    • "method": {
      • "bid_depth_usd": "sum of resting bid notional with price >= mid * (1 - band%), in USD; notional = price * size * contract_value (inverse contracts: size * contract_value); USDT /…",
      • "ask_depth_usd": "sum of resting ask notional with price <= mid * (1 + band%), in USD; same notional rule as bid_depth_usd",
      • "complete": "true when BOTH sides of the snapshot reach the band edge (reach_pct >= band) or the whole side of the book was returned; when false the depth values are lower b…",
      • "history": "sd_book_hist keeps the first snapshot of every 15-minute bucket per contract; each returned point takes, per contract, the first stored snapshot inside the poin…",
      • "exchange_points": "number of returned points in which each exchange had a row that was complete for the band; a changing venue set moves the aggregate, so compare n_included acros…"
      },
    • "meta": {
      • "schema": "coinboss.sd.liquidity/1",
      • "source": [ … 2 ],
      • "observed_at": null,
      • "received_at": 1794542400000,
      • "fetched_at": 1794542565889,
      • "window": "24h",
      • "quality": "FRESH",
      • "is_stale": false,
      • "cache_ttl_s": 120,
      • "fallback": "history is append-only (first snapshot of each 15-minute bucket per contract, 30-day retention); buckets the collector missed are simply absent, never interpola…",
      • "collector_heartbeat_age_s": 3
      }
    }

検証済みサンプル

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

パラメータHTTPレイテンシ結果
band=2&coin=ETH&market=spot2006 ms合格 FRESH
coin=SOL&exchange=gate2002 ms合格 FRESH
band=3&coin=BTC4001 ms合格 想定どおりのエラーを返す

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

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
2m
エッジマイクロキャッシュ
10s
更新頻度
スナップショットは契約ごとに15分おきに保存されます。各ポイントは、バケット内で最も早いスナップショットを使用します（平均値ではなく、ある時点の値）。
ウィンドウ
24h / 7d / 30d.
データソース
24取引所（無期限先物市場および現物市場）の公開RESTの板スナップショットを、CoinBossが収集・保存しています（sd_book_latest、sd_book_hist）。板の厚みとスリッページは、CoinBossが生の価格レベルから算出しています。
取引所カバレッジ
24取引所、取引所 × 市場の組み合わせは38系統。公開スナップショットが仲値から±0.5 / 1 / 2 %に届かない場合（取引所の板段数の上限による）、その価格帯には`complete: false`のフラグが付き、値は下限値となり、集計値から除外されます。`n_included` / `n_fresh`は分母を示し、`excluded_incomplete`には除外されたものが記載されます。
ページネーション
ページングはありません。ポイント数は`range`によって決まります（48 / 84 / 120）。
ソート
時刻の昇順。
単位
Depth in USD notional, bid and ask side reported separately and never added. Spread and slippage in basis points (1 bp = 0.01 %). USDT / USDC / USD quotes are counted 1:1 as USD.
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版
提供開始
2026-11-11

ライブステータス

一部2026-11-13 04:02:45 UTCにチェックHTTP 20012 msスキーマ一致最新データポイントは3m前

収集は2026-11-11に開始したため、長い期間は順次埋まっていきます。欠損したバケットは補間されず、存在しません。2つのポイント間で`n_included`が変化した場合は、算入される契約の集合が変わったことを意味します。

可用性（過去30日間）

408回のチェック中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/liquidity/history一部
パラメータ

string — Coin symbol, case-insensitive (for example `BTC`). Missing or malformed values return 400.

string · デフォルト perp — Market type. Perpetual and spot books are never added together.

string · デフォルト 1 — Distance from mid price in percent.

string · デフォルト 24h — Look-back range: 24h (30-minute points), 7d (2-hour points) or 30d (6-hour points).

string — One exchange id covered for this market (for example `gate`). Default: all exchanges. An exchange that is not covered returns 400.

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