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

1銘柄の先物出来高

自社データ層：1銘柄の先物出来高

GET/api/sd/volume

リクエスト

クエリパラメータ

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

リクエスト例

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

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
coinstring—銘柄シンボル（大文字。例：BTC）。
nownumbermsレスポンスを生成した時点のサーバー時刻。
futuresobject—先物市場のブロックまたは値。
futures.total_usdnumberUSD取引所横断の24h先物出来高（USD建て想定元本）。
futures.n_exchangesnumber—集計に寄与した取引所の数。
futures.by_exchangearray—取引所別の内訳。
futures.by_exchange[]object—取引所別の内訳。
futures.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
futures.by_exchange[].vol_usdnumberUSDUSD建て想定元本での出来高。
futures.by_exchange[].legacy_usdnumberUSD出来高のうち、USDT無期限先物のティッカーセットに由来する部分。
futures.by_exchange[].sd_usdnumberUSDすでに算入済みの追加契約（USDC建て、コイン証拠金型、限月）に由来する部分。
futures.by_exchange[].share_pctnumber%合計に占める割合。
futures.change_24hobject—24h変化。
futures.change_24h.pctnumber%パーセント値。
futures.change_24h.curnumber—現在値。
futures.change_24h.prevnumber—前回値（基準値）。
futures.change_24h.n_matchednumber—比較の両端に存在する項目。
futures.change_24h.n_totalnumber—現在存在する項目。
futures.change_24h.prev_tsnumberms基準スナップショットの時刻。
futures.change_24h.basisstring—先物価格から現物価格を引いた値、またはベーシスのブロック。
futures.selfdata_contractsobject—追加契約：すでに算入済みのものと、まだ保留中のもの。
futures.selfdata_contracts.included_usdnullUSD先物合計に算入済みの追加収集契約（コイン証拠金型、USDC建て、限月）の24h出来高。まだ1件も算入されていない場合はnull。
futures.selfdata_contracts.n_includednumbercount先物合計に算入されている追加収集契約の数（約24時間前の自身のスナップショットがある契約）。
futures.selfdata_contracts.pending_usdnumber|nullUSD保留中の項目の合計。合計値には含まれません。
futures.selfdata_contracts.n_pendingnumbercount24時間前の自身の基準値がないため、まだ算入されていない追加収集契約の数。規模の大きいものは`pending`に記載されます。
futures.selfdata_contracts.pendingarray—収集済みだが未算入の項目。
futures.selfdata_contracts.pending[]object—収集済みだが未算入の項目。
futures.selfdata_contracts.pending[].exchangestring—取引所ID（小文字。例：`binance`）。
futures.selfdata_contracts.pending[].symbolstring—CoinBossが正規化した銘柄シンボル（例：BTCUSDT）。
futures.selfdata_contracts.pending[].marginstring—証拠金通貨の区分。
futures.selfdata_contracts.pending[].contract_typestring—`perpetual`または`delivery`。
futures.selfdata_contracts.pending[].vol_usdnumberUSDUSD建て想定元本での出来高。
futures.selfdata_contracts.pending[].reasonstring—理由コード。
spotobject—現物市場のブロックまたは値。
spot.total_usdnumberUSD取引所横断の24h現物出来高。
spot.n_exchangesnumber—集計に寄与した取引所の数。
spot.asofnumberms使用した最新データの時刻。
spot.by_exchangearray—取引所別の内訳。
spot.by_exchange[]object—取引所別の内訳。
spot.by_exchange[].exchangestring—取引所ID（小文字。例：`binance`）。
spot.by_exchange[].vol_usdnumberUSDUSD建て想定元本での出来高。
spot.by_exchange[].quotestring—この取引所で対象となる建値通貨。
spot.by_exchange[].tsnumbermsタイムスタンプ。
spot.by_exchange[].pricenumber—建値通貨での直近価格（特記がない限りUSDまたはUSDT）。
spot.by_exchange[].age_snumbersこの行が最後に更新されてからの経過秒数。
spot.by_exchange[].share_pctnumber%合計に占める割合。
spot.change_24hobject—24h変化。
spot.change_24h.pctnumber%パーセント値。
spot.change_24h.curnumber—現在値。
spot.change_24h.prevnumber—前回値（基準値）。
spot.change_24h.n_matchednumber—比較の両端に存在する項目。
spot.change_24h.n_totalnumber—現在存在する項目。
spot.change_24h.prev_tsnumberms基準スナップショットの時刻。
spot.change_24h.basisstring—先物価格から現物価格を引いた値、またはベーシスのブロック。
ratiosobject—出来高比率：`futures_to_spot`（24h先物出来高 ÷ 24h現物出来高）と`oi_to_futures_volume`。入力が欠けている場合、それぞれnullになります。
ratios.futures_to_spotnumber—先物出来高を現物出来高で割った値。
ratios.oi_to_futures_volumenumber—建玉を24h先物出来高で割った値。
methodobject—このレスポンスで使用した計算式を平文で記述したもの。
method.futuresstring—先物市場のブロックまたは値。
method.spotstring—現物市場のブロックまたは値。
method.changestring—記載された期間における変化。
method.oi_to_futures_volumestring—`ratios.oi_to_futures_volume`の定義（平文）：USD建ての建玉合計 ÷ USD建ての24h先物出来高。

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

レスポンス例

/api/sd/volume?coin=BTC · 実際のレスポンス（2026-11-13 03:57:37 UTCに取得）。 長い配列とマップは表示用に短縮しています：spot.by_exchangeは14件; futures.by_exchangeは23件; futures.selfdata_contracts.pendingは5件。

  • {
    • "success": true,
    • "coin": "BTC",
    • "now": 1794542257033,
    • "futures": {
      • "total_usd": 79049803843.06,
      • "n_exchanges": 23,
      • "by_exchange": [ … 2 ],
      • "change_24h": { … 7 },
      • "selfdata_contracts": { … 5 }
      },
    • "spot": {
      • "total_usd": 7929483908.44,
      • "n_exchanges": 14,
      • "asof": 1794541800000,
      • "by_exchange": [ … 2 ],
      • "change_24h": { … 7 }
      },
    • "ratios": {
      • "futures_to_spot": 9.9691,
      • "oi_to_futures_volume": 0.6197
      },
    • "method": {
      • "futures": "SUM of each exchange 24h quote turnover in USD for this coin's contracts (ticker fresh within 1h); self-collected coin-margined/USDC/delivery contracts are adde…",
      • "spot": "per exchange: 24h quote turnover summed over that exchange's USD/USDT/USDC-quoted spot pairs of the coin (quote = the largest pair); total = SUM over exchanges …",
      • "change": "same-exchange pairing: only exchanges with both a current value and a snapshot ~24h ago enter numerator and denominator",
      • "oi_to_futures_volume": "total open interest (USD) / 24h futures turnover (USD)"
      }
    }

検証済みサンプル

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

パラメータHTTPレイテンシ結果
coin=ETH20038 ms合格
coin=SOL20046 ms合格
coin=ARKM20043 ms合格
—4001 ms合格 想定どおりのエラーを返す

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

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
30s
エッジマイクロキャッシュ
10s
更新頻度
先物ティッカーは60 sごと（コイン証拠金型/USDC建て/限月契約は120 sごと）。現物スナップショットは10 minごと
ウィンドウ
各取引所が報告する24 hローリング出来高。24 h変化は約24 h前の自社アーカイブとの比較
データソース
24h先物出来高は自社のティッカーコレクター（24のデリバティブ取引所）から、24h現物出来高は自社の現物ティッカーコレクター（binance、okx、bybit、coinbase、kraken、upbitなど14の現物取引所）から取得しています。
取引所カバレッジ
先物：最大24取引所。現物：14取引所、USD / USDT / USDC建てのペア
単位
volumes in USD; changes in percent; ratios dimensionless
算出方法
futures total = SUM(volume_usd) of tickers fresh within 1 h, plus non-USDT-perp contracts once they have their own ~24 h baseline; spot total = SUM of the latest per-exchange snapshot within 30 min; 24 h change by same-exchange pairing; ratios futures_to_spot and oi_to_futures_volume
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版
提供開始
2026-11-11

ライブステータス

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

可用性（過去30日間）

411回のチェック中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/volume利用可能
パラメータ

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

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