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

銘柄データの一括取得（OI、資金調達率、清算、出来高、ロング/ショート）

自社データ層：銘柄データの一括取得（OI / 資金調達率 / 清算 / 出来高 / ロング/ショート。ブロック単位で障害を分離）

GET/api/sd/coin

リクエスト

クエリパラメータ

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

リクエスト例

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

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
coinstring—銘柄シンボル（大文字。例：BTC）。
nownumbermsレスポンスを生成した時点のサーバー時刻。
oiobject—この銘柄について`/api/sd/oi`が返すものと同じオブジェクト。
oi.coinstring—銘柄シンボル（大文字。例：BTC）。
oi.nownumbermsレスポンスを生成した時点のサーバー時刻。
oi.total_usdnumberUSD集計対象の全取引所・全契約の建玉。各取引所の報告値のまま合計しています（USD建て想定元本）。
oi.n_exchangesnumber—合計に含まれる取引所の数。
oi.n_contractsnumber—合計に含まれる契約の数。
oi.asofnumberms集計対象の行のうち最も新しい更新時刻。
oi.total_usd_single_adjustednumberUSD`total_usd`のうち、両側を報告する取引所（`double_sided.exchanges`）の数値を半分にした値。これにより、すべての取引所が片側でカウントされます。
oi.double_sidedobject—ロング＋ショートの建玉を1つの数値として公表していることが判明している取引所。
oi.double_sided.exchangesarray—取引所。
oi.double_sided.exchanges[]string—取引所。
oi.double_sided.oi_usdnumberUSD半分にする前の、それらの取引所が報告した建玉。
oi.by_kindobject—リニア/インバース別の内訳。
oi.by_kind.linear_usdnumberUSDリニア契約（ステーブルコインまたはUSDを証拠金とし、同通貨で決済）の建玉。
oi.by_kind.inverse_usdnumberUSDインバース（コイン証拠金型）契約の建玉。契約価格でUSDに換算しています。
oi.by_marginobject—証拠金通貨別の内訳。
oi.by_margin.othernumberUSDその他の証拠金通貨（例：CMEなどのUSD決済の取引所）。
oi.by_margin.usdtnumberUSDUSDT建て契約。
oi.by_margin.usdcnumberUSDUSDC建て契約。 省略される場合あり
oi.by_margin.coinnumberUSDコイン証拠金型契約。 省略される場合あり
oi.by_contract_typeobject—無期限/限月別の内訳。
oi.by_contract_type.perpetual_usdnumberUSD無期限先物。
oi.by_contract_type.delivery_usdnumberUSD限月先物（デリバリー契約）。
oi.changeobject—1h / 4h / 24hの建玉変化。両端で同一の契約セットを対象に算出しています。 動的キー: h1,h4,h24
oi.change.{*}object—記載された期間における変化。
oi.change.{*}.pctnumber%`prev`と`cur`の間の変化率（%）。
oi.change.{*}.curnumberUSDマッチした契約の現在の合計。
oi.change.{*}.prevnumberUSD`prev_ts`時点における同じ契約の合計。
oi.change.{*}.n_matchednumber—両端に存在する契約（または取引所）。
oi.change.{*}.n_totalnumber—現在存在する契約（または取引所）。
oi.change.{*}.matched_share_pctnumber%現在の建玉のうち、マッチしたセットがカバーする割合。 省略される場合あり
oi.change.{*}.prev_tsnumberms基準スナップショットの時刻。
oi.change.{*}.span_minnumbermin基準時点から現在までの実際の間隔。
oi.change.{*}.basisstring—基準値の取得元となったスナップショット系列。
oi.change.{*}.frozen_excludedobject—2つのスナップショットの間で値が動かなかった（ソースが更新されていない）ため、変化の算出から除外された行。 省略される場合あり
oi.change.{*}.frozen_excluded.n_baselinenumber—基準スナップショット内の項目。 省略される場合あり
oi.change.{*}.frozen_excluded.n_currentnumber—現在のスナップショット内の項目。 省略される場合あり
oi.change.{*}.frozen_excluded.cur_usdnumberUSD現在値。 省略される場合あり
oi.change.{*}.frozen_excluded.prev_usdnumberUSD基準値。 省略される場合あり
oi.by_exchangearray—取引所別の内訳。
oi.by_exchange[]object—取引所別の内訳。
oi.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
oi.by_exchange[].oi_usdnumberUSDUSD建て想定元本での建玉。
oi.by_exchange[].share_pctnumber%合計に占める割合。
oi.by_exchange[].n_contractsnumber—契約数。
oi.by_exchange[].linear_usdnumberUSDリニア契約。
oi.by_exchange[].inverse_usdnumberUSDインバース（コイン証拠金型）契約。
oi.by_exchange[].perpetual_usdnumberUSD無期限先物。
oi.by_exchange[].delivery_usdnumberUSD限月契約。
oi.by_exchange[].oi_sidestring—取引所が両側を1つの数値で報告する場合は`double`、片側を報告する場合は`single`、取引所が明記していない場合は`unstated`。
oi.by_exchange[].oi_usd_single_adjustednumber|nullUSD片側換算値。片側/両側の扱いが明記されていない場合はnull。
oi.by_exchange[].updated_atnumbermsこの行が最後に更新された時刻。
oi.by_exchange[].age_snumbersこの行が最後に更新されてからの経過秒数。
oi.by_exchange[].is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
oi.contractsarray—契約ごとの行。
oi.contracts[]object—契約ごとの行。
oi.contracts[].exchangestring—取引所ID（小文字。例：`binance`）。
oi.contracts[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
oi.contracts[].native_symbolstring|null—取引所の表記そのままのシンボル。
oi.contracts[].oi_usdnumberUSDUSD建て想定元本での建玉。
oi.contracts[].oi_sidestring—`double`、`single`、`unstated`のいずれか。取引所が建玉の両側を1つの数値で報告しているかどうかを示します。
oi.contracts[].oi_usd_singlenumber|nullUSD`oi_usd`の片側換算値。片側/両側の扱いが明記されていない場合はnull。
oi.contracts[].marginstring—証拠金通貨の区分：`usdt`、`usdc`、`coin`、`other`。
oi.contracts[].kindstring—`linear`または`inverse`。
oi.contracts[].contract_typestring—`perpetual`または`delivery`。
oi.contracts[].expiry_tsnumber|nullms限月契約の満期日。無期限先物の場合、または公表されていない場合はnull。
oi.contracts[].margin_basisstring—証拠金区分の判定方法（契約仕様から、または取引所のデフォルトから）。
oi.contracts[].updated_atnumbermsこの行が最後に更新された時刻。
oi.contracts[].age_snumbersこの行が最後に更新されてからの経過秒数。
oi.contracts[].is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
oi.contracts[].collectorstring—この行を生成した内部コレクター。
oi.contracts[].included_sincenumber|nullmsこの契約が合計に算入された時刻。基本セットの場合はnull。
oi.coverageobject—上記の数値に含まれるものと含まれないもの。他のソースと合計値を比較する前に、まずこの内容を比較してください。
oi.coverage.included_exchangesarray—データが合計に含まれている取引所。
oi.coverage.included_exchanges[]string—合計に含まれる取引所。
oi.coverage.pendingarray—収集はしているが、まだ合計に算入されていない契約（たとえば、契約自体の25時間分の履歴を蓄積中の場合）。差分がわかるよう、現在値とともに記載されます。
oi.coverage.pending[]object—収集済みだが未算入の項目。
oi.coverage.pending[].exchangestring—取引所ID（小文字。例：`binance`）。
oi.coverage.pending[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
oi.coverage.pending[].native_symbolstring—取引所の表記そのままのシンボル。
oi.coverage.pending[].marginstring—証拠金通貨の区分。
oi.coverage.pending[].contract_typestring—`perpetual`または`delivery`。
oi.coverage.pending[].oi_usdnumberUSDUSD建て想定元本での建玉。
oi.coverage.pending[].age_snumbersこの行が最後に更新されてからの経過秒数。
oi.coverage.pending[].reasonstring—理由コード。
oi.coverage.pending[].detailstring|null—詳細。
oi.coverage.pending_usdnumber|nullUSD保留中の契約の合計。`total_usd`には含まれません。
oi.coverage.stale_excludedarray—最終更新が利用可能ウィンドウの外にあるため除外された行。 この表の生成に使用したサンプルでは空
oi.coverage.unavailablearray—算入できなかった取引所/契約の組み合わせ。それぞれ理由が付きます。0としてカウントされることはありません。
oi.coverage.unavailable[]object—データが利用できない項目とその理由。0として報告されることはありません。
oi.coverage.unavailable[].exchangestring—取引所ID（小文字。例：`binance`）。
oi.coverage.unavailable[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
oi.coverage.unavailable[].native_symbolstring—取引所の表記そのままのシンボル。
oi.coverage.unavailable[].marginstring—証拠金通貨の区分。
oi.coverage.unavailable[].contract_typestring—`perpetual`または`delivery`。
oi.coverage.unavailable[].reasonstring—理由コード。
oi.coverage.unavailable[].detailstring—詳細。
oi.methodobject—このレスポンスで使用した計算式を平文で記述したもの。
oi.method.totalstring—合計。
oi.method.usdstringUSD値。
oi.method.change_h1_h4string—1hおよび4hの建玉変化の定義（平文）：各契約を、ウィンドウ開始時点に最も近いその契約自身のスナップショットと比較します。
oi.method.change_h24string—24hの建玉変化の定義（平文）：24時間前に最も近い1時間ごとのスナップショットと同一取引所同士で対応付け、値が動いていない基準値は除外します。
oi.method.oi_sidestring—`double`、`single`、`unstated`のいずれか。取引所が建玉の両側を1つの数値で報告しているかどうかを示します。
fundingobject—この銘柄について`/api/sd/funding`が返すものと同じオブジェクト。
funding.coinstring—銘柄シンボル（大文字。例：BTC）。
funding.nownumbermsレスポンスを生成した時点のサーバー時刻。
funding.unitstring—このレスポンス内のすべてのレートフィールドの単位：`fraction`（0.0001 = 0.01 %）。
funding.avg_8hnumberfraction per 8h8h正規化レートの単純平均。1取引所につき1契約。
funding.oi_weighted_8hnumberfraction per 8h8h正規化レートの建玉加重平均。
funding.apr_pctnumber% per year単純な年率換算：8hレート × 3 × 365 × 100。
funding.apr_basisstring—代表値の`apr_pct`がどの集計値に基づいているか。
funding.n_exchangesnumber—集計に寄与した取引所の数。
funding.n_normalizednumber—資金調達間隔が判明しており、8hに正規化できた取引所。
funding.n_unknown_intervalnumber—資金調達間隔が不明なため、集計値から除外された取引所。
funding.settled_cum_7dobject—過去7日間に実際に決済された資金調達率の合計を、決済履歴のある取引所間で平均した値。
funding.settled_cum_7d.avgnumberfraction取引所間の単純平均。
funding.settled_cum_7d.oi_weightednumberfraction建玉加重平均。
funding.settled_cum_7d.nnumber—ウィンドウ全体のデータが揃っている取引所。
funding.settled_cum_30dobject—同上（30日間）。
funding.settled_cum_30d.avgnumberfraction取引所間の単純平均。
funding.settled_cum_30d.oi_weightednumberfraction建玉加重平均。
funding.settled_cum_30d.nnumber—ウィンドウ全体のデータが揃っている取引所。
funding.by_exchangearray—取引所ごとに1行：その銘柄の主要契約（建玉が最大のもの）。
funding.by_exchange[]object—取引所別の内訳。
funding.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
funding.by_exchange[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
funding.by_exchange[].marginstring—証拠金通貨の区分。
funding.by_exchange[].kindstring—種類。
funding.by_exchange[].primaryboolean—集計値でその取引所を代表する契約（建玉が最大の契約）の場合はtrue。このリストでは常にtrueです。
funding.by_exchange[].ratenumber—レート。
funding.by_exchange[].interval_hnumberh間隔。
funding.by_exchange[].rate_8hnumber—8時間に正規化したレート。
funding.by_exchange[].apr_pctnumber% per year年率換算のパーセント値。
funding.by_exchange[].next_funding_timenumber|nullmsタイムスタンプ。
funding.by_exchange[].next_derivedboolean—取引所が`next_funding_time`を公表しておらず、次のUTC正時として推定した場合はtrue（1時間ごとに決済する取引所のみ）。
funding.by_exchange[].predicted_ratenull—次回期間の参考レート。公表されていない場合はnull。
funding.by_exchange[].oi_usdnumber|nullUSDUSD建て想定元本での建玉。
funding.by_exchange[].updated_atnumbermsこの行が最後に更新された時刻。
funding.by_exchange[].age_snumbersこの行が最後に更新されてからの経過秒数。
funding.by_exchange[].is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
funding.by_exchange[].settledobject|null—実際の決済記録。公開の履歴が存在しない場合はnull。
funding.by_exchange[].settled.last_ratenumberfraction直近の決済（`last_time`）で実際に適用された資金調達率。取引所の資金調達履歴に基づきます（0.0001 = 0.01 %）。 省略される場合あり
funding.by_exchange[].settled.last_timenumbermsタイムスタンプ。 省略される場合あり
funding.by_exchange[].settled.interval_hnumberh間隔。 省略される場合あり
funding.by_exchange[].settled.cum_7dnumberfraction直近7日間にこの契約で決済された資金調達率の合計（0.0015 = 0.15 %）。決済の記録がない場合はnull。 省略される場合あり
funding.by_exchange[].settled.n_7dnumbercount直近7日間について収集された決済レコードの数。 省略される場合あり
funding.by_exchange[].settled.n_7d_expectednumbercount7日間のウィンドウ全体に含まれるはずの決済回数：168 ÷ 決済間隔（時間）。間隔が不明な場合はnull。 省略される場合あり
funding.by_exchange[].settled.cum_7d_completeboolean—履歴が7日間のウィンドウの開始時点までカバーし、想定される決済回数の90 %以上を保持している場合はtrue。 省略される場合あり
funding.by_exchange[].settled.cum_30dnumberfraction直近30日間にこの契約で決済された資金調達率の合計（0.006 = 0.6 %）。 省略される場合あり
funding.by_exchange[].settled.n_30dnumbercount直近30日間について収集された決済レコードの数。 省略される場合あり
funding.by_exchange[].settled.n_30d_expectednumbercount30日間のウィンドウ全体に含まれるはずの決済回数：720 ÷ 決済間隔（時間）。間隔が不明な場合はnull。 省略される場合あり
funding.by_exchange[].settled.cum_30d_completeboolean—履歴が30日間のウィンドウの開始時点までカバーし、想定される決済回数の90 %以上を保持している場合はtrue。 省略される場合あり
funding.by_exchange[].settled.history_fromnumberms保持している最も古い記録。 省略される場合あり
funding.other_contractsarray—同じ銘柄のその他の契約（USDC建て、コイン証拠金型など）。集計値には含まれません。
funding.other_contracts[]object—取引所の追加の資金調達契約（コイン証拠金型、USDC建てなど）1件。その取引所の代表契約ではなく、集計値から除外されます。
funding.other_contracts[].exchangestring—取引所ID（小文字。例：`binance`）。
funding.other_contracts[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
funding.other_contracts[].marginstring—証拠金通貨の区分。
funding.other_contracts[].kindstring—種類。
funding.other_contracts[].primaryboolean—このリストのすべての行でfalse。この契約は、集計値でその取引所を代表する契約ではありません。
funding.other_contracts[].ratenumber—レート。
funding.other_contracts[].interval_hnumber|nullh間隔。
funding.other_contracts[].rate_8hnumber|null—8時間に正規化したレート。
funding.other_contracts[].apr_pctnumber|null% per year年率換算のパーセント値。
funding.other_contracts[].next_funding_timenumber|nullmsタイムスタンプ。
funding.other_contracts[].next_derivedboolean—取引所が`next_funding_time`を公表しておらず、次のUTC正時として推定した場合はtrue（1時間ごとに決済する取引所のみ）。
funding.other_contracts[].predicted_ratenumber|null—次回期間の参考レート。公表されていない場合はnull。
funding.other_contracts[].oi_usdnumber|nullUSDUSD建て想定元本での建玉。
funding.other_contracts[].updated_atnumbermsこの行が最後に更新された時刻。
funding.other_contracts[].age_snumbersこの行が最後に更新されてからの経過秒数。
funding.other_contracts[].is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
funding.other_contracts[].settledobject|null—実際の決済記録。公開の履歴が存在しない場合はnull。
funding.other_contracts[].settled.last_ratenumberfraction直近の決済（`last_time`）で実際に適用された資金調達率。取引所の資金調達履歴に基づきます（0.0001 = 0.01 %）。 省略される場合あり
funding.other_contracts[].settled.last_timenumbermsタイムスタンプ。 省略される場合あり
funding.other_contracts[].settled.interval_hnumberh間隔。 省略される場合あり
funding.other_contracts[].settled.cum_7dnumberfraction直近7日間にこの契約で決済された資金調達率の合計（0.0015 = 0.15 %）。決済の記録がない場合はnull。 省略される場合あり
funding.other_contracts[].settled.n_7dnumbercount直近7日間について収集された決済レコードの数。 省略される場合あり
funding.other_contracts[].settled.n_7d_expectednumbercount7日間のウィンドウ全体に含まれるはずの決済回数：168 ÷ 決済間隔（時間）。間隔が不明な場合はnull。 省略される場合あり
funding.other_contracts[].settled.cum_7d_completeboolean—履歴が7日間のウィンドウの開始時点までカバーし、想定される決済回数の90 %以上を保持している場合はtrue。 省略される場合あり
funding.other_contracts[].settled.cum_30dnumberfraction直近30日間にこの契約で決済された資金調達率の合計（0.006 = 0.6 %）。 省略される場合あり
funding.other_contracts[].settled.n_30dnumbercount直近30日間について収集された決済レコードの数。 省略される場合あり
funding.other_contracts[].settled.n_30d_expectednumbercount30日間のウィンドウ全体に含まれるはずの決済回数：720 ÷ 決済間隔（時間）。間隔が不明な場合はnull。 省略される場合あり
funding.other_contracts[].settled.cum_30d_completeboolean—履歴が30日間のウィンドウの開始時点までカバーし、想定される決済回数の90 %以上を保持している場合はtrue。 省略される場合あり
funding.other_contracts[].settled.history_fromnumberms保持している最も古い記録。 省略される場合あり
funding.coverageobject—上記の数値に含まれるものと含まれないもの。他のソースと合計値を比較する前に、まずこの内容を比較してください。
funding.coverage.settle_history_exchangesarray—実際の決済記録を収集している取引所。
funding.coverage.settle_history_exchanges[]string—この銘柄について、実際の資金調達決済レコードを収集している取引所のID。
funding.coverage.no_settle_historyarray—決済履歴の公開ソースがない取引所。これらの`settled`はnullになります。
funding.coverage.no_settle_history[]string—決済履歴が収集されていない代表契約の取引所ID。そのため、その`settled`ブロックはnullになります。
funding.coverage.unknown_intervalarray—資金調達間隔を判定できなかった行。 この表の生成に使用したサンプルでは空
funding.coverage.no_liveness_excludedarray—契約に取引の兆候がない（最近のティッカー、建玉、気配値がない）ため除外された行。 この表の生成に使用したサンプルでは空
funding.methodobject—このレスポンスで使用した計算式を平文で記述したもの。
funding.method.ratestring—レート。
funding.method.rate_8hstring—8時間に正規化したレート。
funding.method.apr_pctstring% per year年率換算のパーセント値。
funding.method.aggregatestring—取引所横断の集計値。
funding.method.settledstring—実際の決済記録。公開の履歴が存在しない場合はnull。
funding.method.predicted_ratestring—次回期間の参考レート。公表されていない場合はnull。
funding.method.livenessstring—稼働していない契約を除外するルール（平文）：資金調達率の行は、1h以内のティッカー、3h以内の建玉、または3h以内のその契約自身の価格のいずれかがある場合にのみ算入されます。
liquidationsobject—この銘柄について`/api/sd/liquidations`が返すものと同じオブジェクト。
liquidations.coinstring—銘柄シンボル（大文字。例：BTC）。
liquidations.nownumbermsレスポンスを生成した時点のサーバー時刻。
liquidations.windowsobject—各ウィンドウの合計（キーは`1h`、`4h`、`12h`、`24h`など）。 動的キー: 1h,4h,12h,24h
liquidations.windows.{*}object—ウィンドウごとの値。
liquidations.windows.{*}.long_usdnumberUSD清算されたロングポジション。そのウィンドウをカバーするソースがない場合はnull。
liquidations.windows.{*}.short_usdnumberUSD清算されたショートポジション。そのウィンドウをカバーするソースがない場合はnull。
liquidations.windows.{*}.total_usdnumberUSDロング＋ショート。
liquidations.windows.{*}.countnumber—清算注文の件数。
liquidations.windows.{*}.long_pctnumber%合計に占めるロングの割合。
liquidations.windows.{*}.max_orderobject—ウィンドウ内で最大の単一清算。
liquidations.windows.{*}.max_order.exchangestring—取引所ID（小文字。例：`binance`）。
liquidations.windows.{*}.max_order.symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
liquidations.windows.{*}.max_order.sidestring—`long` / `short`または`buy` / `sell`。
liquidations.windows.{*}.max_order.pricenumber—建値通貨での直近価格（特記がない限りUSDまたはUSDT）。
liquidations.windows.{*}.max_order.qtynumber—数量。
liquidations.windows.{*}.max_order.contract_multipliernumberx最大注文の契約における建値1単位あたりのコイン数（1000PEPE型の契約では1000）。`price`と`qty`は、すでにコイン1枚単位に換算済みです。
liquidations.windows.{*}.max_order.value_usdnumberUSD値。
liquidations.windows.{*}.max_order.timestampnumbermsタイムスタンプ。
liquidations.by_exchangeobject—各ウィンドウの取引所別内訳。 動的キー: 1h,4h,12h,24h
liquidations.by_exchange.{*}array—取引所別の内訳。
liquidations.by_exchange.{*}[]object—取引所別の内訳。
liquidations.by_exchange.{*}[].exchangestring—取引所ID（小文字。例：`binance`）。
liquidations.by_exchange.{*}[].long_usdnumberUSDロング側。
liquidations.by_exchange.{*}[].short_usdnumberUSDショート側。
liquidations.by_exchange.{*}[].total_usdnumberUSD合計。
liquidations.by_exchange.{*}[].countnumber—項目数。
liquidations.by_exchange.{*}[].share_pctnumber%合計に占める割合。
liquidations.last_event_atnumbermsこの銘柄の直近の清算時刻。
liquidations.last_event_age_snumbersそのイベントからの経過秒数。
liquidations.sourcesarray—各清算フィードの状態：収集方法と最後にデータが届いた時刻。
liquidations.sources[]object—データソース。
liquidations.sources[].exchangestring—取引所ID（小文字。例：`binance`）。
liquidations.sources[].viastring—収集方法（`ws`、`rest`など）。
liquidations.sources[].statusstring—フィード自身のイベント時刻とハートビートから判定したフィードの状態。
liquidations.sources[].feed_last_event_age_snumber|nullsイベントからの経過秒数。
liquidations.sources[].ws_heartbeat_age_snumber|nullsイベントからの経過秒数。
liquidations.sources[].judged_bystring—ステータスの判定に使用したタイムスタンプ。
liquidations.sources[].coin_last_event_age_snumber|nullsイベントからの経過秒数。
liquidations.sources[].min_event_usdnumberUSDフィードが配信する最小注文サイズ。これより小さい清算は、この取引所では確認できません。
liquidations.sources[].notestring|null—備考。
liquidations.sources[].node_heartbeat_age_snumbersイベントからの経過秒数。 省略される場合あり
liquidations.sources[].pipeline_last_event_age_snumbersイベントからの経過秒数。 省略される場合あり
liquidations.coverageobject—上記の数値に含まれるものと含まれないもの。他のソースと合計値を比較する前に、まずこの内容を比較してください。
liquidations.coverage.collected_exchangesarray—公開の清算フィードがあり、CoinBossが収集している取引所。
liquidations.coverage.collected_exchanges[]string—収集対象の取引所。
liquidations.coverage.unavailablearray—算入できなかった取引所/契約の組み合わせ。それぞれ理由が付きます。0としてカウントされることはありません。
liquidations.coverage.unavailable[]object—データが利用できない項目とその理由。0として報告されることはありません。
liquidations.coverage.unavailable[].exchangestring—取引所ID（小文字。例：`binance`）。
liquidations.coverage.unavailable[].reasonstring—理由コード。
liquidations.methodobject—このレスポンスで使用した計算式を平文で記述したもの。
liquidations.method.eventstring—清算イベント1件の定義に関する注記（平文）：取引所のストリームがプッシュした、または取引所の公開REST APIが返した清算注文1件を指します。
liquidations.method.sidestring—`long` / `short`または`buy` / `sell`。
liquidations.method.value_usdstringUSD値。
liquidations.method.dedupestring—重複排除に関する注記（平文）：イベントは取引所、シンボル、サイド、価格、金額、タイムスタンプの組み合わせで一意とし、取引所の注文IDが提供される場合はそれも加えます。
liquidations.method.null_rulestring—収集されたイベントが1件もないウィンドウは0ではなくnullを返すこと、および公開フィードのない取引所の記載場所に関する注記（平文）。
liquidations.method.binance_notestring—Binanceは1シンボルにつき1秒あたり最大1件の清算しかプッシュしないため、Binanceの合計は下限値であるという注意事項（平文）。
liquidations.method.min_event_usdstringUSDフィードが配信する最小注文。
volumeobject—この銘柄について`/api/sd/volume`が返すものと同じオブジェクト。
volume.coinstring—銘柄シンボル（大文字。例：BTC）。
volume.nownumbermsレスポンスを生成した時点のサーバー時刻。
volume.futuresobject—先物市場のブロックまたは値。
volume.futures.total_usdnumberUSD取引所横断の24h先物出来高（USD建て想定元本）。
volume.futures.n_exchangesnumber—集計に寄与した取引所の数。
volume.futures.by_exchangearray—取引所別の内訳。
volume.futures.by_exchange[]object—取引所別の内訳。
volume.futures.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
volume.futures.by_exchange[].vol_usdnumberUSDUSD建て想定元本での出来高。
volume.futures.by_exchange[].legacy_usdnumberUSD出来高のうち、USDT無期限先物のティッカーセットに由来する部分。
volume.futures.by_exchange[].sd_usdnumberUSDすでに算入済みの追加契約（USDC建て、コイン証拠金型、限月）に由来する部分。
volume.futures.by_exchange[].share_pctnumber%合計に占める割合。
volume.futures.change_24hobject—24h変化。
volume.futures.change_24h.pctnumber%パーセント値。
volume.futures.change_24h.curnumber—現在値。
volume.futures.change_24h.prevnumber—前回値（基準値）。
volume.futures.change_24h.n_matchednumber—比較の両端に存在する項目。
volume.futures.change_24h.n_totalnumber—現在存在する項目。
volume.futures.change_24h.prev_tsnumberms基準スナップショットの時刻。
volume.futures.change_24h.basisstring—先物価格から現物価格を引いた値、またはベーシスのブロック。
volume.futures.selfdata_contractsobject—追加契約：すでに算入済みのものと、まだ保留中のもの。
volume.futures.selfdata_contracts.included_usdnullUSD先物合計に算入済みの追加収集契約（コイン証拠金型、USDC建て、限月）の24h出来高。まだ1件も算入されていない場合はnull。
volume.futures.selfdata_contracts.n_includednumbercount先物合計に算入されている追加収集契約の数（約24時間前の自身のスナップショットがある契約）。
volume.futures.selfdata_contracts.pending_usdnumber|nullUSD保留中の項目の合計。合計値には含まれません。
volume.futures.selfdata_contracts.n_pendingnumbercount24時間前の自身の基準値がないため、まだ算入されていない追加収集契約の数。規模の大きいものは`pending`に記載されます。
volume.futures.selfdata_contracts.pendingarray—収集済みだが未算入の項目。
volume.futures.selfdata_contracts.pending[]object—収集済みだが未算入の項目。
volume.futures.selfdata_contracts.pending[].exchangestring—取引所ID（小文字。例：`binance`）。
volume.futures.selfdata_contracts.pending[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
volume.futures.selfdata_contracts.pending[].marginstring—証拠金通貨の区分。
volume.futures.selfdata_contracts.pending[].contract_typestring—`perpetual`または`delivery`。
volume.futures.selfdata_contracts.pending[].vol_usdnumberUSDUSD建て想定元本での出来高。
volume.futures.selfdata_contracts.pending[].reasonstring—理由コード。
volume.spotobject—現物市場のブロックまたは値。
volume.spot.total_usdnumberUSD取引所横断の24h現物出来高。
volume.spot.n_exchangesnumber—集計に寄与した取引所の数。
volume.spot.asofnumberms使用した最新データの時刻。
volume.spot.by_exchangearray—取引所別の内訳。
volume.spot.by_exchange[]object—取引所別の内訳。
volume.spot.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
volume.spot.by_exchange[].vol_usdnumberUSDUSD建て想定元本での出来高。
volume.spot.by_exchange[].quotestring—この取引所で対象となる建値通貨。
volume.spot.by_exchange[].tsnumbermsタイムスタンプ。
volume.spot.by_exchange[].pricenumber—建値通貨での直近価格（特記がない限りUSDまたはUSDT）。
volume.spot.by_exchange[].age_snumbersこの行が最後に更新されてからの経過秒数。
volume.spot.by_exchange[].share_pctnumber%合計に占める割合。
volume.spot.change_24hobject—24h変化。
volume.spot.change_24h.pctnumber%パーセント値。
volume.spot.change_24h.curnumber—現在値。
volume.spot.change_24h.prevnumber—前回値（基準値）。
volume.spot.change_24h.n_matchednumber—比較の両端に存在する項目。
volume.spot.change_24h.n_totalnumber—現在存在する項目。
volume.spot.change_24h.prev_tsnumberms基準スナップショットの時刻。
volume.spot.change_24h.basisstring—先物価格から現物価格を引いた値、またはベーシスのブロック。
volume.ratiosobject—出来高比率：`futures_to_spot`（24h先物出来高 ÷ 24h現物出来高）と`oi_to_futures_volume`。入力が欠けている場合、それぞれnullになります。
volume.ratios.futures_to_spotnumber—先物出来高を現物出来高で割った値。
volume.ratios.oi_to_futures_volumenumber—建玉を24h先物出来高で割った値。
volume.methodobject—このレスポンスで使用した計算式を平文で記述したもの。
volume.method.futuresstring—先物市場のブロックまたは値。
volume.method.spotstring—現物市場のブロックまたは値。
volume.method.changestring—記載された期間における変化。
volume.method.oi_to_futures_volumestring—`ratios.oi_to_futures_volume`の定義（平文）：USD建ての建玉合計 ÷ USD建ての24h先物出来高。
lsobject—この銘柄について`/api/sd/ls`が返すものと同じオブジェクト。
ls.coinstring—銘柄シンボル（大文字。例：BTC）。
ls.nownumbermsレスポンスを生成した時点のサーバー時刻。
ls.accountobject—全アカウントのうち、ネットロングとネットショートのアカウントがそれぞれ占める割合。
ls.account.long_pctnumber%ロングの割合。
ls.account.short_pctnumber%ショートの割合。
ls.account.rationumber—比率。
ls.account.n_exchangesnumber—集計に寄与した取引所の数。
ls.account.by_exchangearray—取引所別の内訳。
ls.account.by_exchange[]object—取引所別の内訳。
ls.account.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
ls.account.by_exchange[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
ls.account.by_exchange[].long_pctnumber%ロングの割合。
ls.account.by_exchange[].short_pctnumber%ショートの割合。
ls.account.by_exchange[].rationumber—比率。
ls.account.by_exchange[].updated_atnumbermsこの行が最後に更新された時刻。
ls.account.by_exchange[].age_snumbersこの行が最後に更新されてからの経過秒数。
ls.account.by_exchange[].is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
ls.account.by_exchange[].sourcestring—値の取得元。
ls.account.by_exchange[].periodstring—期間。
ls.top_accountobject—同上。ただし、取引所が定義するトップトレーダーに限定。
ls.top_account.long_pctnumber|null%ロングの割合。
ls.top_account.short_pctnumber|null%ショートの割合。
ls.top_account.rationumber|null—比率。
ls.top_account.n_exchangesnumber—集計に寄与した取引所の数。
ls.top_account.by_exchangearray—取引所別の内訳。
ls.top_account.by_exchange[]object—取引所別の内訳。
ls.top_account.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
ls.top_account.by_exchange[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
ls.top_account.by_exchange[].long_pctnumber%ロングの割合。
ls.top_account.by_exchange[].short_pctnumber%ショートの割合。
ls.top_account.by_exchange[].rationumber—比率。
ls.top_account.by_exchange[].updated_atnumbermsこの行が最後に更新された時刻。
ls.top_account.by_exchange[].age_snumbersこの行が最後に更新されてからの経過秒数。
ls.top_account.by_exchange[].is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
ls.top_account.by_exchange[].sourcestring—値の取得元。
ls.top_account.by_exchange[].periodstring—期間。
ls.top_positionobject—トップトレーダーが保有するポジションに占めるロングとショートの割合。
ls.top_position.long_pctnumber|null%ロングの割合。
ls.top_position.short_pctnumber|null%ショートの割合。
ls.top_position.rationumber|null—比率。
ls.top_position.n_exchangesnumber—集計に寄与した取引所の数。
ls.top_position.by_exchangearray—取引所別の内訳。
ls.top_position.by_exchange[]object—取引所別の内訳。
ls.top_position.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
ls.top_position.by_exchange[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
ls.top_position.by_exchange[].long_pctnumber%ロングの割合。
ls.top_position.by_exchange[].short_pctnumber%ショートの割合。
ls.top_position.by_exchange[].rationumber—比率。
ls.top_position.by_exchange[].updated_atnumbermsこの行が最後に更新された時刻。
ls.top_position.by_exchange[].age_snumbersこの行が最後に更新されてからの経過秒数。
ls.top_position.by_exchange[].is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
ls.top_position.by_exchange[].sourcestring—値の取得元。
ls.top_position.by_exchange[].periodstring—期間。
ls.position_allobject—全ポジションに占めるロングとショートの割合（公表している取引所のみ）。
ls.position_all.long_pctnumber|null%ロングの割合。
ls.position_all.short_pctnumber|null%ショートの割合。
ls.position_all.rationumber|null—比率。
ls.position_all.n_exchangesnumber—集計に寄与した取引所の数。
ls.position_all.by_exchangearray—取引所別の内訳。
ls.position_all.by_exchange[]object—取引所別の内訳。
ls.position_all.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
ls.position_all.by_exchange[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
ls.position_all.by_exchange[].long_pctnumber%ロングの割合。
ls.position_all.by_exchange[].short_pctnumber%ショートの割合。
ls.position_all.by_exchange[].rationumber—比率。
ls.position_all.by_exchange[].updated_atnumbermsこの行が最後に更新された時刻。
ls.position_all.by_exchange[].age_snumbersこの行が最後に更新されてからの経過秒数。
ls.position_all.by_exchange[].is_staleboolean—行が鮮度ウィンドウより古い場合はtrue。鮮度切れの行は合計に使用されません。
ls.position_all.by_exchange[].sourcestring—値の取得元。
ls.position_all.by_exchange[].periodstring—期間。
ls.takerobject—テイカー買いとテイカー売りの出来高の割合。
ls.taker.long_pctnumber|null%ロングの割合。
ls.taker.short_pctnumber|null%ショートの割合。
ls.taker.rationumber|null—比率。
ls.taker.n_exchangesnumber—集計に寄与した取引所の数。
ls.taker.by_exchangearray—取引所別の内訳。
ls.definitionsobject—各指標の定義。5つの指標はそれぞれ異なる問いに答えるものであり、混合することはありません。 省略される場合あり
ls.definitions.accountstring—アカウントベースの指標。 省略される場合あり
ls.definitions.top_accountstring—トップトレーダーのアカウント指標。 省略される場合あり
ls.definitions.top_positionstring—トップトレーダーのポジション指標。 省略される場合あり
ls.definitions.position_allstring—全ポジションの指標。 省略される場合あり
ls.definitions.takerstring—テイカー買い/売りの指標。 省略される場合あり
ls.methodobject—このレスポンスで使用した計算式を平文で記述したもの。 省略される場合あり
ls.method.normalizestring—正規化に関する注記（平文）：各取引所の値は、ロング % + ショート % = 100となるように再スケールされ、比率 = ロング % ÷ ショート %です。 省略される場合あり
ls.method.aggregatestring—取引所横断の集計値。 省略される場合あり
ls.method.freshnessstring—鮮度ルール（平文）：24時間以内に更新された行が表示され、2時間より古い行には`is_stale`が付きます。 省略される場合あり
errorsobject—バンドルのうち構築に失敗した部分。パーツ名をキーとします。すべてのパーツが揃っている場合は空です。 省略される場合あり

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

レスポンス例

直近の成功レスポンスが大きすぎて表示できないため、例は保存されていません。プレイグラウンドでエンドポイントを呼び出してください。

検証済みサンプル

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

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

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

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
15s
エッジマイクロキャッシュ
10s
更新頻度
/api/sd/oi、/api/sd/funding、/api/sd/liquidations、/api/sd/volume、/api/sd/ls を参照（ポーリングは60 s〜5 min。清算はリアルタイム。現物は10 minごと）
ウィンドウ
ブロックごとの最新スナップショットと、各ブロック固有のローリングウィンドウ
データソース
1銘柄の建玉、資金調達率、清算、出来高、ロング/ショートの各ブロックをまとめて返します。いずれも、CoinBoss自社のコレクターが約30取引所（binance、okx、bybit、bitget、gate、hyperliquidなど）の公開APIをポーリングして構築しています。
取引所カバレッジ
単一ブロックの5つのエンドポイントと同じ。契約リストは60行に切り詰められます
単位
USD notional for OI / volume / liquidations; funding as fraction; long/short in percent
算出方法
same builders as the five single-block endpoints
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版
提供開始
2026-11-11

ライブステータス

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

可用性（過去30日間）

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

直近のプローブで検出されたスキーマのずれ
  • 返されているがドキュメントに未記載: oi.coverage.stale_excluded[], oi.coverage.stale_excluded[].exchange, oi.coverage.stale_excluded[].symbol, oi.coverage.stale_excluded[].oi_usd, oi.coverage.stale_excluded[].age_s, oi.coverage.stale_excluded[].reason, ls.taker.by_exchange[], ls.taker.by_exchange[].exchange, ls.taker.by_exchange[].symbol, ls.taker.by_exchange[].long_pct

エラー

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

コード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/coin利用可能
パラメータ

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

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