24h Volume—Open Interest—24h Liquidations$1.36B24h Long/Short—BTC Dominance—ETH Dominance—
App
Language ▾
$ USD ▾
/api/sd/cme/overview
GETPartialPARTIAL

CME futures overview

CME open interest and daily volume for one coin, per product (standard and micro contracts), converted to coin and USD notional, plus the latest CFTC positioning summary.

GET/api/sd/cme/overview
Partial coverage. Open interest and volume in contracts and in coin are exchange figures. USD notional currently uses a labelled daily reference price (`price_src`) because the official CME settlement price is not collected yet; the gap is listed under `coverage.unavailable` and the response is marked PARTIAL for that reason.

Request

Query parameters

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

Example request

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

Response fields

The field table is generated from real responses, so it lists exactly what the endpoint returns. Paths use a[] for array items and {*} for objects keyed by a dynamic name such as a coin or an exchange.

FieldTypeUnitDescription
successboolean—true when the request succeeded. On failure the body is `{ success: false, code, error, request_id }`.
schemastring—Schema id of this response. It changes only when an existing field changes meaning or type.
nownumbermsServer time when the response was built.
coinstring—Coin symbol (upper case).
trade_datestring|null—CME trade date of the figures.
oi_contractsobject|null—Open interest in contracts, one-sided. dynamic keys: BTC,MBT
oi_contracts.{*}numbercontractsOpen interest in contracts, one-sided.
oi_coinnumber|nullcoinOpen interest in coin: contracts × contract multiplier.
oi_usdnumber|nullUSDOpen interest as USD notional: coin × `price`.
volume_contractsobject|null—Total volume of the trade date in contracts (electronic, floor and off-exchange). dynamic keys: BTC,MBT
volume_contracts.{*}numbercontractsTotal volume of the trade date in contracts (electronic, floor and off-exchange).
volume_coinnumber|nullcoinVolume in coin: contracts × contract multiplier.
volume_usdnumber|nullUSDVolume as USD notional: coin × `price`.
pricenumber|nullUSDPrice used for USD conversion.
price_srcstring|null—Where `price` comes from: CME front-month settlement when collected, otherwise a labelled daily reference price.
productsarray|null—One row per CME product of the coin.
products[]object—One row per CME product of the coin.
products[].productstring—CME product code.
products[].namestring—CME product name.
products[].multipliernumbercoinCoins per contract.
products[].oi_contractsnumbercontractsOpen interest in contracts, one-sided.
products[].oi_coinnumbercoinOpen interest in coin: contracts × contract multiplier.
products[].oi_usdnumberUSDOpen interest as USD notional: coin × `price`.
products[].volume_contractsnumbercontractsTotal volume of the trade date in contracts (electronic, floor and off-exchange).
products[].globex_volume_contractsnumbercontractsElectronic (Globex) part of the volume.
products[].volume_coinnumbercoinVolume in coin: contracts × contract multiplier.
products[].volume_usdnumberUSDVolume as USD notional: coin × `price`.
products[].settlenullUSDFront-month settlement price; `null` while not collected.
products[].settle_monthnull—Contract month of the settlement price.
products[].settle_srcnull—Source of the settlement price.
cotobject|null—Summary of the latest CFTC Commitments of Traders report for the coin.
cot.report_datestring—As-of date of the CFTC report (normally a Tuesday).
cot.is_staleboolean—True when the data is older than its fresh window.
cot.contractsarray—CME products included.
cot.contracts[]string—CME products included.
cot.unitstring—Unit of the position fields: `coin`, `contracts` or `usd`.
cot.oi_contractsobject—Open interest in contracts, one-sided. dynamic keys: BTC,MBT
cot.oi_contracts.{*}numbercontractsOpen interest in contracts, one-sided.
cot.oi_coinnumbercoinOpen interest in coin: contracts × contract multiplier.
cot.dealer_netnumber—Dealers: long − short.
cot.asset_mgr_netnumber—Asset managers: long − short.
cot.lev_money_netnumber—Leveraged funds: long − short.
cot.other_rept_netnumber—Other reportables: long − short.
cot.nonrept_netnumber—Non-reportables: long − short.
coverageobject—What is and is not included in the numbers. Compare this before comparing totals with another source.
coverage.included_exchangesarray—Sources whose fresh data is included.
coverage.included_exchanges[]string—Sources whose fresh data is included.
coverage.unavailablearray—Sources that could not be included, each with a reason. They are never counted as 0.
coverage.unavailable[]object—Sources that could not be included, each with a reason. They are never counted as 0.
coverage.unavailable[].exchangestring—Exchange id (lower case).
coverage.unavailable[].fieldstring—Field that is missing. may be absent
coverage.unavailable[].reasonstring—Machine-readable reason code.
coverage.unavailable[].detailstring—Human-readable explanation of the reason.
coverage.stale_excludedarray—Rows left out because their last update is outside the fresh window. empty in the samples used to generate this table
methodobject—Plain-text statement of the formulas used for this response, one entry per field.
method.oi_contractsstring—Formula note for `oi_contracts`, plain text.
method.oi_coinstring—Formula note for `oi_coin`, plain text.
method.oi_usdstring—Formula note for `oi_usd`, plain text.
method.volume_contractsstring—Formula note for `volume_contracts`, plain text.
method.volume_usdstring—Formula note for `volume_usd`, plain text.
method.is_stalestring—Formula note for `is_stale`, plain text.
method.cotstring—Formula note for `cot`, plain text.
metaobject—Lineage and freshness of this response.
meta.schemastring—Schema id of this response. It changes only when an existing field changes meaning or type.
meta.sourcearray—Upstream public endpoints the data was collected from.
meta.source[]object—Upstream public endpoints the data was collected from.
meta.source[].exchangestring—Exchange id (lower case).
meta.source[].endpointstring—Public endpoint of the source the collector reads (shown for lineage; clients never call it).
meta.observed_atnumber|nullmsTimestamp given by the source for the data.
meta.received_atnumber|nullmsTime the CoinBoss collector received the data.
meta.fetched_atnumbermsTime this response was assembled.
meta.windowstring—Time window the numbers cover.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN or UNAVAILABLE, judged from data timestamps and coverage.
meta.is_staleboolean—True when the data is older than its fresh window.
meta.cache_ttl_snumbersCache lifetime of this response.
meta.fallbackstring—What the endpoint returns when the collector or a source fails.

Generated 2026-11-11 23:00 UTC from 4 real responses.

Example response

/api/sd/cme/overview?coin=BTC · Real response captured 2026-11-13 03:58:26 UTC. Long arrays and maps are shortened for display: meta.source had 3 items.

  • {
    • "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…"
      }
    }

Verified samples

Besides the example above, the probe calls this endpoint with these parameters and checks the schema each time.

ParametersHTTPLatencyResult
coin=ETH2005 msPass PARTIAL
coin=XRP2005 msPass PARTIAL
coin=PEPE2002 msPass UNAVAILABLE
—4001 msPass returns the expected error

Checked 2026-11-13 03:58:26 UTC

Details

Authentication
None. Public endpoint.
Rate limit
1200 requests per minute per IP
Server cache
5m
Edge micro-cache
10s
Update frequency
CME publishes once per trading day; the collector runs three times per day (04:20, 11:20, 17:20 UTC).
Window
Latest CME trade date (`trade_date`).
Data sources
CME Group daily volume and open-interest bulletin files; CFTC Commitments of Traders (Traders in Financial Futures, futures only). Collected and stored by CoinBoss (sd_cme_daily, sd_cme_cot_weekly).
Exchange coverage
Eight CME products: BTC, MBT, ETH, MET, SOL, MSL, XRP, MXP. Open interest is single-sided, in contracts.
Units
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`.
Method
oi_coin = Σ over products (open interest in contracts × multiplier); oi_usd = oi_coin × price. Volume is total daily volume (electronic, floor and off-exchange).
Timestamps
Unix epoch milliseconds (UTC) unless the field description says otherwise
Response format
json
Stability
Stable
Available since
2026-11-11

Live status

PartialChecked 2026-11-13 03:58:26 UTCHTTP 2005 msSchema matchesNewest data point 10.6h old

The endpoint reports data quality PARTIAL — Open interest and volume in contracts and in coin are exchange figures. USD notional currently uses a labelled daily reference price (`price_src`) because the official CME settlement price is not collected yet; the gap is listed under `coverage.unavailable` and the response is marked PARTIAL for that reason.

Availability, last 30 days

99.75% of 406 checks passed

Errors

Failed calls share one shape on every endpoint. The full list is on the errors page. Errors and rate limits →

CodeHTTPMeaningWhat to do
INVALID_PARAM400A required parameter is missing or a value is not accepted. `param` names the parameter when it is known.Do not retry unchanged; fix the request.
UNAUTHORIZED401The `CB-API-KEY` header was sent but the key is unknown or revoked. Public data needs no key — drop the header or use a valid key.Do not retry unchanged.
FORBIDDEN403The route is not part of the public API (internal or account-only).Do not retry.
NOT_FOUND404Unknown route, or the requested coin / exchange / fund does not exist.Do not retry; check the path and identifiers against the catalog.
RATE_LIMITED429More requests than the per-minute limit. `Retry-After` gives the seconds to wait.Wait for `Retry-After`, then retry with backoff.
INTERNAL500Unexpected server error. The message is generic by design; quote `request_id` when reporting it.Retry once after a few seconds; report it with the request id if it persists.
UPSTREAM_FAILED503The data source behind this endpoint did not answer in time. No stale or substitute numbers are returned in its place.Retry with backoff; check the status page.
UNAVAILABLE501 / 503The dataset is temporarily not ready (cache warming) or the endpoint has no lawful public source yet.Retry later; the catalog marks endpoints that are unavailable by design.
REQUEST_FAILED200Some older endpoints answer HTTP 200 with `success: false`. Always check `success`, not only the HTTP status.Depends on the message; treat as a failed request.

Try it

GET/api/sd/cme/overviewPartial
Parameters

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

Request URLhttps://www.coinboss.com/api/sd/cme/overview?coin=BTC
Choose an endpoint and press “Send request”. The response, headers and timing will appear here.