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

CME先物の概要

1銘柄のCMEの建玉と日次出来高を、商品別（標準契約とマイクロ契約）に、コイン建ておよびUSD建ての想定元本に換算して返します。最新のCFTCポジション動向のサマリーも含まれます。

GET/api/sd/cme/overview
部分的なカバレッジ. 契約数およびコイン数での建玉と出来高は取引所の数値です。USD建て想定元本は、CMEの公式決済価格をまだ収集していないため、現在はラベル付きの日次参照価格（`price_src`）を使用しています。この欠落は`coverage.unavailable`に記載され、そのためレスポンスはPARTIALとされます。

リクエスト

クエリパラメータ

名前型必須デフォルト指定可能な値説明
coinstring必須——銘柄シンボル。`BTC`、`ETH`、`SOL`、`XRP`にはCME商品があります。その他の有効なシンボルは、`meta.quality = "UNAVAILABLE"`とともに200を返します。 例: BTC

リクエスト例

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

レスポンスフィールド

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

フィールド型単位説明
successboolean—リクエストが成功した場合はtrue。失敗した場合、ボディは`{ success: false, code, error, request_id }`になります。
schemastring—このレスポンスのスキーマID。既存フィールドの意味または型が変わった場合にのみ変更されます。
nownumbermsレスポンスを生成した時点のサーバー時刻。
coinstring—銘柄シンボル（大文字）。
trade_datestring|null—数値のCME取引日。
oi_contractsobject|null—契約数ベースの建玉（片側）。 動的キー: BTC,MBT
oi_contracts.{*}numbercontracts契約数ベースの建玉（片側）。
oi_coinnumber|nullcoinコイン数での建玉：contracts × contract multiplier。
oi_usdnumber|nullUSDUSD建て想定元本としての建玉：coin × `price`。
volume_contractsobject|null—取引日の出来高合計（契約数。電子取引、立会場取引、取引所外取引を含む）。 動的キー: BTC,MBT
volume_contracts.{*}numbercontracts取引日の出来高合計（契約数。電子取引、立会場取引、取引所外取引を含む）。
volume_coinnumber|nullcoinコイン数での出来高：contracts × contract multiplier。
volume_usdnumber|nullUSDUSD建て想定元本としての出来高：coin × `price`。
pricenumber|nullUSDUSD換算に使用する価格。
price_srcstring|null—`price`の出所：収集済みの場合はCMEの期近限月の決済価格、それ以外はラベル付きの日次参照価格。
productsarray|null—その銘柄のCME商品ごとに1行。
products[]object—その銘柄のCME商品ごとに1行。
products[].productstring—CME商品コード。
products[].namestring—CME商品名。
products[].multipliernumbercoin1契約あたりのコイン数。
products[].oi_contractsnumbercontracts契約数ベースの建玉（片側）。
products[].oi_coinnumbercoinコイン数での建玉：contracts × contract multiplier。
products[].oi_usdnumberUSDUSD建て想定元本としての建玉：coin × `price`。
products[].volume_contractsnumbercontracts取引日の出来高合計（契約数。電子取引、立会場取引、取引所外取引を含む）。
products[].globex_volume_contractsnumbercontracts出来高のうち電子取引（Globex）の部分。
products[].volume_coinnumbercoinコイン数での出来高：contracts × contract multiplier。
products[].volume_usdnumberUSDUSD建て想定元本としての出来高：coin × `price`。
products[].settlenullUSD期近限月の決済価格。未収集の間は`null`。
products[].settle_monthnull—決済価格の限月。
products[].settle_srcnull—決済価格のソース。
cotobject|null—その銘柄に関する最新のCFTC建玉明細報告（Commitments of Traders）の概要。
cot.report_datestring—CFTC報告の基準日（通常は火曜日）。
cot.is_staleboolean—データが鮮度ウィンドウより古い場合はtrue。
cot.contractsarray—含まれるCME商品。
cot.contracts[]string—含まれるCME商品。
cot.unitstring—ポジションフィールドの単位：`coin`、`contracts`、`usd`のいずれか。
cot.oi_contractsobject—契約数ベースの建玉（片側）。 動的キー: BTC,MBT
cot.oi_contracts.{*}numbercontracts契約数ベースの建玉（片側）。
cot.oi_coinnumbercoinコイン数での建玉：contracts × contract multiplier。
cot.dealer_netnumber—ディーラー：ロング − ショート。
cot.asset_mgr_netnumber—アセットマネージャー：ロング − ショート。
cot.lev_money_netnumber—レバレッジファンド：ロング − ショート。
cot.other_rept_netnumber—その他の報告対象：ロング − ショート。
cot.nonrept_netnumber—非報告対象：ロング − ショート。
coverageobject—数値に含まれるものと含まれないもの。他のソースと合計値を比較する前に、まずこの内容を比較してください。
coverage.included_exchangesarray—鮮度内のデータが算入されているソース。
coverage.included_exchanges[]string—鮮度内のデータが算入されているソース。
coverage.unavailablearray—算入できなかったソース。それぞれ理由が付きます。0としてカウントされることはありません。
coverage.unavailable[]object—算入できなかったソース。それぞれ理由が付きます。0としてカウントされることはありません。
coverage.unavailable[].exchangestring—取引所ID（小文字）。
coverage.unavailable[].fieldstring—欠落しているフィールド。 省略される場合あり
coverage.unavailable[].reasonstring—機械可読な理由コード。
coverage.unavailable[].detailstring—人が読める形式での理由の説明。
coverage.stale_excludedarray—最終更新が鮮度ウィンドウの外にあるため除外された行。 この表の生成に使用したサンプルでは空
methodobject—このレスポンスで使用した計算式を平文で記述したもの。フィールドごとに1エントリー。
method.oi_contractsstring—`oi_contracts`の計算式に関する注記（平文）。
method.oi_coinstring—`oi_coin`の計算式に関する注記（平文）。
method.oi_usdstring—`oi_usd`の計算式に関する注記（平文）。
method.volume_contractsstring—`volume_contracts`の計算式に関する注記（平文）。
method.volume_usdstring—`volume_usd`の計算式に関する注記（平文）。
method.is_stalestring—`is_stale`の計算式に関する注記（平文）。
method.cotstring—`cot`の計算式に関する注記（平文）。
metaobject—このレスポンスのデータリネージと鮮度。
meta.schemastring—このレスポンスのスキーマID。既存フィールドの意味または型が変わった場合にのみ変更されます。
meta.sourcearray—データの収集元である上流の公開エンドポイント。
meta.source[]object—データの収集元である上流の公開エンドポイント。
meta.source[].exchangestring—取引所ID（小文字）。
meta.source[].endpointstring—コレクターが読み取るソースの公開エンドポイント（データリネージのために表示。クライアントが呼び出すことはありません）。
meta.observed_atnumber|nullmsソースがデータに付与したタイムスタンプ。
meta.received_atnumber|nullmsCoinBossのコレクターがデータを受信した時刻。
meta.fetched_atnumbermsこのレスポンスが組み立てられた時刻。
meta.windowstring—数値が対象とする時間ウィンドウ。
meta.qualitystring—FRESH、PARTIAL、STALE、BROKEN、UNAVAILABLEのいずれか。データのタイムスタンプとカバレッジから判定します。
meta.is_staleboolean—データが鮮度ウィンドウより古い場合はtrue。
meta.cache_ttl_snumbersこのレスポンスのキャッシュ有効期間。
meta.fallbackstring—コレクターまたはソースに障害が発生した場合にエンドポイントが返す内容。

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

レスポンス例

/api/sd/cme/overview?coin=BTC · 実際のレスポンス（2026-11-13 03:58:26 UTCに取得）。 長い配列とマップは表示用に短縮しています：meta.sourceは3件。

  • {
    • "success": true,
    • "schema": "coinboss.sd.cme/1",
    • "now": 1794542306145,
    • "coin": "BTC",
    • "trade_date": "2026-11-11",
    • "oi_contracts": {
      • "BTC": 19533,
      • "MBT": 24382
      },
    • "oi_coin": 100103.2,
    • "oi_usd": 7409157367.61,
    • "volume_contracts": {
      • "BTC": 8985,
      • "MBT": 35304
      },
    • "volume_coin": 48455.4,
    • "volume_usd": 3586435637.53,
    • "price": 74015.19,
    • "price_src": "ref_binance_1d_close",
    • "products": [
      • { … 13 },
      • { … 13 }
      ],
    • "cot": {
      • "report_date": "2026-11-03",
      • "is_stale": false,
      • "contracts": [ … 2 ],
      • "unit": "coin",
      • "oi_contracts": { … 2 },
      • "oi_coin": 89918.8,
      • "dealer_net": 2309.4,
      • "asset_mgr_net": 12126.5,
      • "lev_money_net": -13486.4,
      • "other_rept_net": -676,
      • "nonrept_net": -273.5
      },
    • "coverage": {
      • "included_exchanges": [ … 2 ],
      • "unavailable": [ … 1 ],
      • "stale_excluded": []
      },
    • "method": {
      • "oi_contracts": "open interest in contracts (one-sided) per CME product, from the CME daily volume & open interest report",
      • "oi_coin": "sum over products of oi_contracts x contract multiplier (BTC 5, MBT 0.1, ETH 50, MET 0.1, SOL 500, MSL 25, XRP 50000, MXP 2500 coins per contract)",
      • "oi_usd": "oi_coin x price; price = CME front-month final settlement price when collected (price_src=cme_settle_front_month), otherwise a reference spot price for the same…",
      • "volume_contracts": "CME total volume for the trade date in contracts (Globex + pit + ex-pit + OTC/cleared); globex_volume_contracts is the Globex part",
      • "volume_usd": "volume in coins (contracts x multiplier) x the same price as oi_usd",
      • "is_stale": "trade_date 22:00 UTC is more than 120h old",
      • "cot": "latest CFTC Commitments of Traders (TFF, futures only) row(s) for the coin: positions converted to coins with the contract multiplier; net = long - short"
      },
    • "meta": {
      • "schema": "coinboss.sd.cme/1",
      • "source": [ … 2 ],
      • "observed_at": 1794434400000,
      • "received_at": 1794504014502,
      • "fetched_at": 1794542306145,
      • "window": "latest",
      • "quality": "PARTIAL",
      • "is_stale": false,
      • "cache_ttl_s": 300,
      • "fallback": "on collector failure the last stored CME trade date is served with its real trade_date; it is flagged is_stale=true once older than 120h; nothing is interpolate…"
      }
    }

検証済みサンプル

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

パラメータHTTPレイテンシ結果
coin=ETH2005 ms合格 PARTIAL
coin=XRP2005 ms合格 PARTIAL
coin=PEPE2002 ms合格 UNAVAILABLE
—4001 ms合格 想定どおりのエラーを返す

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

詳細

認証
不要。公開エンドポイントです。
レート制限
IPごとに毎分1200リクエスト
サーバーキャッシュ
5m
エッジマイクロキャッシュ
10s
更新頻度
CMEは取引日ごとに1回公表します。コレクターは1日3回実行されます（04:20、11:20、17:20 UTC）。
ウィンドウ
CMEの最新取引日（`trade_date`）。
データソース
CME Groupの日次出来高・建玉ブレティンファイル、およびCFTC建玉明細報告（Commitments of Traders。Traders in Financial Futures、先物のみ）。CoinBossが収集・保存しています（sd_cme_daily、sd_cme_cot_weekly）。
取引所カバレッジ
CMEの8商品：BTC、MBT、ETH、MET、SOL、MSL、XRP、MXP。建玉は片側で、契約数ベースです。
単位
Contracts are single-sided. Coin = contracts × contract multiplier (BTC 5, MBT 0.1, ETH 50, MET 0.1, SOL 500, MSL 25, XRP 50,000, MXP 2,500). USD notional = coin × `price`.
算出方法
oi_coin = Σ over products (open interest in contracts × multiplier); oi_usd = oi_coin × price. Volume is total daily volume (electronic, floor and off-exchange).
タイムスタンプ
フィールドの説明に別途記載がない限り、Unixエポックミリ秒（UTC）
レスポンス形式
json
安定性
安定版
提供開始
2026-11-11

ライブステータス

一部2026-11-13 03:58:26 UTCにチェックHTTP 2005 msスキーマ一致最新データポイントは10.6h前

エンドポイントが報告するデータ品質はPARTIALです — 契約数およびコイン数での建玉と出来高は取引所の数値です。USD建て想定元本は、CMEの公式決済価格をまだ収集していないため、現在はラベル付きの日次参照価格（`price_src`）を使用しています。この欠落は`coverage.unavailable`に記載され、そのためレスポンスはPARTIALとされます。

可用性（過去30日間）

406回のチェック中99.75%が合格

エラー

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

コード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/cme/overview一部
パラメータ

string — Coin symbol. `BTC`, `ETH`, `SOL` and `XRP` have CME products; other valid symbols return 200 with `meta.quality = "UNAVAILABLE"`.

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