/api/sd/cme/overview
GETSebagianPARTIAL

Ikhtisar futures CME

Open interest dan volume harian CME untuk satu koin, per produk (kontrak standar dan mikro), dikonversi ke jumlah koin dan nosional USD, ditambah ringkasan posisi CFTC terbaru.

GET/api/sd/cme/overview
Cakupan sebagian. Open interest dan volume dalam kontrak dan dalam koin adalah angka bursa. Nosional USD saat ini memakai harga acuan harian yang diberi label (`price_src`) karena harga penyelesaian resmi CME belum dikumpulkan; kekurangan ini tercantum di `coverage.unavailable` dan karena itu respons ditandai PARTIAL.

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
coinstringWajib——Simbol koin. `BTC`, `ETH`, `SOL`, dan `XRP` memiliki produk CME; simbol valid lainnya mengembalikan 200 dengan `meta.quality = "UNAVAILABLE"`. Contoh: BTC

Contoh permintaan

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

Kolom respons

Tabel kolom dihasilkan dari respons nyata, sehingga memuat persis apa yang dikembalikan endpoint. Path memakai a[] untuk item array dan {*} untuk objek yang kuncinya berupa nama dinamis seperti koin atau bursa.

KolomTipeSatuanDeskripsi
successboolean—true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`.
schemastring—ID skema respons ini. ID hanya berubah jika kolom yang sudah ada berubah makna atau tipe.
nownumbermsWaktu server saat respons disusun.
coinstring—Simbol koin (huruf besar).
trade_datestring|null—Tanggal perdagangan CME untuk angka-angka tersebut.
oi_contractsobject|null—Open interest dalam kontrak, satu sisi. kunci dinamis: BTC,MBT
oi_contracts.{*}numbercontractsOpen interest dalam kontrak, satu sisi.
oi_coinnumber|nullcoinOpen interest dalam koin: kontrak × pengali kontrak.
oi_usdnumber|nullUSDOpen interest sebagai nosional USD: koin × `price`.
volume_contractsobject|null—Total volume tanggal perdagangan dalam kontrak (elektronik, lantai bursa, dan di luar bursa). kunci dinamis: BTC,MBT
volume_contracts.{*}numbercontractsTotal volume tanggal perdagangan dalam kontrak (elektronik, lantai bursa, dan di luar bursa).
volume_coinnumber|nullcoinVolume dalam koin: kontrak × pengali kontrak.
volume_usdnumber|nullUSDVolume sebagai nosional USD: koin × `price`.
pricenumber|nullUSDHarga yang dipakai untuk konversi ke USD.
price_srcstring|null—Asal `price`: harga penyelesaian bulan terdekat CME jika dikumpulkan, selain itu harga acuan harian yang diberi label.
productsarray|null—Satu baris per produk CME untuk koin tersebut.
products[]object—Satu baris per produk CME untuk koin tersebut.
products[].productstring—Kode produk CME.
products[].namestring—Nama produk CME.
products[].multipliernumbercoinJumlah koin per kontrak.
products[].oi_contractsnumbercontractsOpen interest dalam kontrak, satu sisi.
products[].oi_coinnumbercoinOpen interest dalam koin: kontrak × pengali kontrak.
products[].oi_usdnumberUSDOpen interest sebagai nosional USD: koin × `price`.
products[].volume_contractsnumbercontractsTotal volume tanggal perdagangan dalam kontrak (elektronik, lantai bursa, dan di luar bursa).
products[].globex_volume_contractsnumbercontractsBagian elektronik (Globex) dari volume.
products[].volume_coinnumbercoinVolume dalam koin: kontrak × pengali kontrak.
products[].volume_usdnumberUSDVolume sebagai nosional USD: koin × `price`.
products[].settlenullUSDHarga penyelesaian bulan terdekat; `null` selama belum dikumpulkan.
products[].settle_monthnull—Bulan kontrak harga penyelesaian.
products[].settle_srcnull—Sumber harga penyelesaian.
cotobject|null—Ringkasan laporan CFTC Commitments of Traders terbaru untuk koin tersebut.
cot.report_datestring—Tanggal as-of laporan CFTC (biasanya hari Selasa).
cot.is_staleboolean—True jika data lebih lama dari jendela kesegarannya.
cot.contractsarray—Produk CME yang disertakan.
cot.contracts[]string—Produk CME yang disertakan.
cot.unitstring—Satuan kolom posisi: `coin`, `contracts`, atau `usd`.
cot.oi_contractsobject—Open interest dalam kontrak, satu sisi. kunci dinamis: BTC,MBT
cot.oi_contracts.{*}numbercontractsOpen interest dalam kontrak, satu sisi.
cot.oi_coinnumbercoinOpen interest dalam koin: kontrak × pengali kontrak.
cot.dealer_netnumber—Dealer: long − short.
cot.asset_mgr_netnumber—Manajer aset: long − short.
cot.lev_money_netnumber—Dana leverage: long − short.
cot.other_rept_netnumber—Wajib lapor lainnya: long − short.
cot.nonrept_netnumber—Tidak wajib lapor: long − short.
coverageobject—Apa yang termasuk dan tidak termasuk dalam angka-angka ini. Bandingkan ini terlebih dahulu sebelum membandingkan total dengan sumber lain.
coverage.included_exchangesarray—Sumber yang data segarnya disertakan.
coverage.included_exchanges[]string—Sumber yang data segarnya disertakan.
coverage.unavailablearray—Sumber yang tidak dapat disertakan, masing-masing dengan alasannya. Sumber tersebut tidak pernah dihitung sebagai 0.
coverage.unavailable[]object—Sumber yang tidak dapat disertakan, masing-masing dengan alasannya. Sumber tersebut tidak pernah dihitung sebagai 0.
coverage.unavailable[].exchangestring—ID bursa (huruf kecil).
coverage.unavailable[].fieldstring—Kolom yang tidak ada. bisa tidak ada
coverage.unavailable[].reasonstring—Kode alasan yang dapat dibaca mesin.
coverage.unavailable[].detailstring—Penjelasan alasan yang dapat dibaca manusia.
coverage.stale_excludedarray—Baris yang tidak dimasukkan karena pembaruan terakhirnya berada di luar jendela kesegaran. kosong pada sampel yang dipakai untuk menghasilkan tabel ini
methodobject—Pernyataan teks biasa tentang rumus yang dipakai untuk respons ini, satu entri per kolom.
method.oi_contractsstring—Catatan rumus untuk `oi_contracts`, teks biasa.
method.oi_coinstring—Catatan rumus untuk `oi_coin`, teks biasa.
method.oi_usdstring—Catatan rumus untuk `oi_usd`, teks biasa.
method.volume_contractsstring—Catatan rumus untuk `volume_contracts`, teks biasa.
method.volume_usdstring—Catatan rumus untuk `volume_usd`, teks biasa.
method.is_stalestring—Catatan rumus untuk `is_stale`, teks biasa.
method.cotstring—Catatan rumus untuk `cot`, teks biasa.
metaobject—Silsilah data dan kesegaran respons ini.
meta.schemastring—ID skema respons ini. ID hanya berubah jika kolom yang sudah ada berubah makna atau tipe.
meta.sourcearray—Endpoint publik hulu tempat data dikumpulkan.
meta.source[]object—Endpoint publik hulu tempat data dikumpulkan.
meta.source[].exchangestring—ID bursa (huruf kecil).
meta.source[].endpointstring—Endpoint publik sumber yang dibaca kolektor (ditampilkan sebagai silsilah data; klien tidak pernah memanggilnya).
meta.observed_atnumber|nullmsStempel waktu yang diberikan sumber untuk data tersebut.
meta.received_atnumber|nullmsWaktu kolektor CoinBoss menerima data.
meta.fetched_atnumbermsWaktu respons ini disusun.
meta.windowstring—Jendela waktu yang dicakup angka-angka ini.
meta.qualitystring—FRESH, PARTIAL, STALE, BROKEN, atau UNAVAILABLE, dinilai dari stempel waktu data dan cakupan.
meta.is_staleboolean—True jika data lebih lama dari jendela kesegarannya.
meta.cache_ttl_snumbersMasa hidup cache respons ini.
meta.fallbackstring—Apa yang dikembalikan endpoint ketika kolektor atau sumber gagal.

Dihasilkan 2026-11-11 23:00 UTC dari 4 respons nyata.

Contoh respons

/api/sd/cme/overview?coin=BTC · Respons nyata yang direkam 2026-11-13 03:58:26 UTC. Array dan map yang panjang dipersingkat untuk tampilan: meta.source berisi 3 item.

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

Sampel terverifikasi

Selain contoh di atas, probe memanggil endpoint ini dengan parameter berikut dan memeriksa skemanya setiap kali.

ParameterHTTPLatensiHasil
coin=ETH2005 msLolos PARTIAL
coin=XRP2005 msLolos PARTIAL
coin=PEPE2002 msLolos UNAVAILABLE
—4001 msLolos mengembalikan error yang diharapkan

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

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
5m
Mikro-cache edge
10s
Frekuensi pembaruan
CME memublikasikan sekali per hari perdagangan; kolektor berjalan tiga kali per hari (04:20, 11:20, 17:20 UTC).
Jendela
Tanggal perdagangan CME terbaru (`trade_date`).
Sumber data
File buletin harian volume dan open interest CME Group; CFTC Commitments of Traders (Traders in Financial Futures, hanya futures). Dikumpulkan dan disimpan oleh CoinBoss (sd_cme_daily, sd_cme_cot_weekly).
Cakupan bursa
Delapan produk CME: BTC, MBT, ETH, MET, SOL, MSL, XRP, MXP. Open interest bersifat satu sisi, dalam kontrak.
Satuan
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`.
Metode
oi_coin = Σ over products (open interest in contracts × multiplier); oi_usd = oi_coin × price. Volume is total daily volume (electronic, floor and off-exchange).
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil
Tersedia sejak
2026-11-11

Status langsung

SebagianDiperiksa 2026-11-13 03:58:26 UTCHTTP 2005 msSkema sesuaiTitik data terbaru berusia 10.6h

Endpoint melaporkan kualitas data PARTIAL — Open interest dan volume dalam kontrak dan dalam koin adalah angka bursa. Nosional USD saat ini memakai harga acuan harian yang diberi label (`price_src`) karena harga penyelesaian resmi CME belum dikumpulkan; kekurangan ini tercantum di `coverage.unavailable` dan karena itu respons ditandai PARTIAL.

Ketersediaan, 30 hari terakhir

99.75% dari 406 pemeriksaan lolos

Error

Panggilan yang gagal memiliki satu bentuk yang sama di semua endpoint. Daftar lengkapnya ada di halaman error. Error dan batas permintaan →

KodeHTTPArtiTindakan
INVALID_PARAM400Parameter wajib tidak ada atau suatu nilai tidak diterima. `param` menyebutkan nama parameternya jika diketahui.Jangan mengulang tanpa perubahan; perbaiki permintaannya.
UNAUTHORIZED401Header `CB-API-KEY` dikirim tetapi kuncinya tidak dikenal atau sudah dicabut. Data publik tidak memerlukan kunci — hapus header tersebut atau gunakan kunci yang valid.Jangan mengulang tanpa perubahan.
FORBIDDEN403Rute ini bukan bagian dari API publik (internal atau khusus akun).Jangan mengulang.
NOT_FOUND404Rute tidak dikenal, atau koin / bursa / dana yang diminta tidak ada.Jangan mengulang; periksa path dan pengenal terhadap katalog.
RATE_LIMITED429Jumlah permintaan melebihi batas per menit. `Retry-After` memberikan jumlah detik untuk menunggu.Tunggu selama `Retry-After`, lalu ulangi dengan backoff.
INTERNAL500Error server yang tidak terduga. Pesannya sengaja dibuat generik; sertakan `request_id` saat melaporkannya.Ulangi sekali setelah beberapa detik; laporkan beserta ID permintaan jika masih terjadi.
UPSTREAM_FAILED503Sumber data di balik endpoint ini tidak menjawab tepat waktu. Tidak ada angka usang atau angka pengganti yang dikembalikan sebagai gantinya.Ulangi dengan backoff; periksa halaman status.
UNAVAILABLE501 / 503Dataset untuk sementara belum siap (cache sedang diisi) atau endpoint belum memiliki sumber publik yang sah.Ulangi nanti; katalog menandai endpoint yang memang tidak tersedia secara desain.
REQUEST_FAILED200Beberapa endpoint lama menjawab HTTP 200 dengan `success: false`. Selalu periksa `success`, bukan hanya status HTTP.Bergantung pada pesannya; perlakukan sebagai permintaan yang gagal.

Coba

GET/api/sd/cme/overviewSebagian
Parameter

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

URL permintaanhttps://www.coinboss.com/api/sd/cme/overview?coin=BTC
Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.