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.
/api/sd/cme/overviewPermintaan
Parameter kueri
| Nama | Tipe | Wajib | Default | Nilai yang diizinkan | Deskripsi |
|---|---|---|---|---|---|
| coin | string | Wajib | — | — | 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.
| Kolom | Tipe | Satuan | Deskripsi |
|---|---|---|---|
| success | boolean | — | true jika permintaan berhasil. Jika gagal, body-nya adalah `{ success: false, code, error, request_id }`. |
| schema | string | — | ID skema respons ini. ID hanya berubah jika kolom yang sudah ada berubah makna atau tipe. |
| now | number | ms | Waktu server saat respons disusun. |
| coin | string | — | Simbol koin (huruf besar). |
| trade_date | string|null | — | Tanggal perdagangan CME untuk angka-angka tersebut. |
| oi_contracts | object|null | — | Open interest dalam kontrak, satu sisi. kunci dinamis: BTC,MBT |
| oi_contracts.{*} | number | contracts | Open interest dalam kontrak, satu sisi. |
| oi_coin | number|null | coin | Open interest dalam koin: kontrak × pengali kontrak. |
| oi_usd | number|null | USD | Open interest sebagai nosional USD: koin × `price`. |
| volume_contracts | object|null | — | Total volume tanggal perdagangan dalam kontrak (elektronik, lantai bursa, dan di luar bursa). kunci dinamis: BTC,MBT |
| volume_contracts.{*} | number | contracts | Total volume tanggal perdagangan dalam kontrak (elektronik, lantai bursa, dan di luar bursa). |
| volume_coin | number|null | coin | Volume dalam koin: kontrak × pengali kontrak. |
| volume_usd | number|null | USD | Volume sebagai nosional USD: koin × `price`. |
| price | number|null | USD | Harga yang dipakai untuk konversi ke USD. |
| price_src | string|null | — | Asal `price`: harga penyelesaian bulan terdekat CME jika dikumpulkan, selain itu harga acuan harian yang diberi label. |
| products | array|null | — | Satu baris per produk CME untuk koin tersebut. |
| products[] | object | — | Satu baris per produk CME untuk koin tersebut. |
| products[].product | string | — | Kode produk CME. |
| products[].name | string | — | Nama produk CME. |
| products[].multiplier | number | coin | Jumlah koin per kontrak. |
| products[].oi_contracts | number | contracts | Open interest dalam kontrak, satu sisi. |
| products[].oi_coin | number | coin | Open interest dalam koin: kontrak × pengali kontrak. |
| products[].oi_usd | number | USD | Open interest sebagai nosional USD: koin × `price`. |
| products[].volume_contracts | number | contracts | Total volume tanggal perdagangan dalam kontrak (elektronik, lantai bursa, dan di luar bursa). |
| products[].globex_volume_contracts | number | contracts | Bagian elektronik (Globex) dari volume. |
| products[].volume_coin | number | coin | Volume dalam koin: kontrak × pengali kontrak. |
| products[].volume_usd | number | USD | Volume sebagai nosional USD: koin × `price`. |
| products[].settle | null | USD | Harga penyelesaian bulan terdekat; `null` selama belum dikumpulkan. |
| products[].settle_month | null | — | Bulan kontrak harga penyelesaian. |
| products[].settle_src | null | — | Sumber harga penyelesaian. |
| cot | object|null | — | Ringkasan laporan CFTC Commitments of Traders terbaru untuk koin tersebut. |
| cot.report_date | string | — | Tanggal as-of laporan CFTC (biasanya hari Selasa). |
| cot.is_stale | boolean | — | True jika data lebih lama dari jendela kesegarannya. |
| cot.contracts | array | — | Produk CME yang disertakan. |
| cot.contracts[] | string | — | Produk CME yang disertakan. |
| cot.unit | string | — | Satuan kolom posisi: `coin`, `contracts`, atau `usd`. |
| cot.oi_contracts | object | — | Open interest dalam kontrak, satu sisi. kunci dinamis: BTC,MBT |
| cot.oi_contracts.{*} | number | contracts | Open interest dalam kontrak, satu sisi. |
| cot.oi_coin | number | coin | Open interest dalam koin: kontrak × pengali kontrak. |
| cot.dealer_net | number | — | Dealer: long − short. |
| cot.asset_mgr_net | number | — | Manajer aset: long − short. |
| cot.lev_money_net | number | — | Dana leverage: long − short. |
| cot.other_rept_net | number | — | Wajib lapor lainnya: long − short. |
| cot.nonrept_net | number | — | Tidak wajib lapor: long − short. |
| coverage | object | — | Apa yang termasuk dan tidak termasuk dalam angka-angka ini. Bandingkan ini terlebih dahulu sebelum membandingkan total dengan sumber lain. |
| coverage.included_exchanges | array | — | Sumber yang data segarnya disertakan. |
| coverage.included_exchanges[] | string | — | Sumber yang data segarnya disertakan. |
| coverage.unavailable | array | — | 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[].exchange | string | — | ID bursa (huruf kecil). |
| coverage.unavailable[].field | string | — | Kolom yang tidak ada. bisa tidak ada |
| coverage.unavailable[].reason | string | — | Kode alasan yang dapat dibaca mesin. |
| coverage.unavailable[].detail | string | — | Penjelasan alasan yang dapat dibaca manusia. |
| coverage.stale_excluded | array | — | Baris yang tidak dimasukkan karena pembaruan terakhirnya berada di luar jendela kesegaran. kosong pada sampel yang dipakai untuk menghasilkan tabel ini |
| method | object | — | Pernyataan teks biasa tentang rumus yang dipakai untuk respons ini, satu entri per kolom. |
| method.oi_contracts | string | — | Catatan rumus untuk `oi_contracts`, teks biasa. |
| method.oi_coin | string | — | Catatan rumus untuk `oi_coin`, teks biasa. |
| method.oi_usd | string | — | Catatan rumus untuk `oi_usd`, teks biasa. |
| method.volume_contracts | string | — | Catatan rumus untuk `volume_contracts`, teks biasa. |
| method.volume_usd | string | — | Catatan rumus untuk `volume_usd`, teks biasa. |
| method.is_stale | string | — | Catatan rumus untuk `is_stale`, teks biasa. |
| method.cot | string | — | Catatan rumus untuk `cot`, teks biasa. |
| meta | object | — | Silsilah data dan kesegaran respons ini. |
| meta.schema | string | — | ID skema respons ini. ID hanya berubah jika kolom yang sudah ada berubah makna atau tipe. |
| meta.source | array | — | Endpoint publik hulu tempat data dikumpulkan. |
| meta.source[] | object | — | Endpoint publik hulu tempat data dikumpulkan. |
| meta.source[].exchange | string | — | ID bursa (huruf kecil). |
| meta.source[].endpoint | string | — | Endpoint publik sumber yang dibaca kolektor (ditampilkan sebagai silsilah data; klien tidak pernah memanggilnya). |
| meta.observed_at | number|null | ms | Stempel waktu yang diberikan sumber untuk data tersebut. |
| meta.received_at | number|null | ms | Waktu kolektor CoinBoss menerima data. |
| meta.fetched_at | number | ms | Waktu respons ini disusun. |
| meta.window | string | — | Jendela waktu yang dicakup angka-angka ini. |
| meta.quality | string | — | FRESH, PARTIAL, STALE, BROKEN, atau UNAVAILABLE, dinilai dari stempel waktu data dan cakupan. |
| meta.is_stale | boolean | — | True jika data lebih lama dari jendela kesegarannya. |
| meta.cache_ttl_s | number | s | Masa hidup cache respons ini. |
| meta.fallback | string | — | 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"
- "cot"
- "report_date""2026-11-03"
- "is_stale"false
- "contracts"
- "unit""coin"
- "oi_contracts"
- "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"
- "unavailable"
- "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"
- "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.
| Parameter | HTTP | Latensi | Hasil |
|---|---|---|---|
| coin=ETH | 200 | 5 ms | Lolos PARTIAL |
| coin=XRP | 200 | 5 ms | Lolos PARTIAL |
| coin=PEPE | 200 | 2 ms | Lolos UNAVAILABLE |
| — | 400 | 1 ms | Lolos 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
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 →
| Kode | HTTP | Arti | Tindakan |
|---|---|---|---|
| INVALID_PARAM | 400 | Parameter wajib tidak ada atau suatu nilai tidak diterima. `param` menyebutkan nama parameternya jika diketahui. | Jangan mengulang tanpa perubahan; perbaiki permintaannya. |
| UNAUTHORIZED | 401 | Header `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. |
| FORBIDDEN | 403 | Rute ini bukan bagian dari API publik (internal atau khusus akun). | Jangan mengulang. |
| NOT_FOUND | 404 | Rute tidak dikenal, atau koin / bursa / dana yang diminta tidak ada. | Jangan mengulang; periksa path dan pengenal terhadap katalog. |
| RATE_LIMITED | 429 | Jumlah permintaan melebihi batas per menit. `Retry-After` memberikan jumlah detik untuk menunggu. | Tunggu selama `Retry-After`, lalu ulangi dengan backoff. |
| INTERNAL | 500 | Error 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_FAILED | 503 | Sumber 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. |
| UNAVAILABLE | 501 / 503 | Dataset 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_FAILED | 200 | Beberapa endpoint lama menjawab HTTP 200 dengan `success: false`. Selalu periksa `success`, bukan hanya status HTTP. | Bergantung pada pesannya; perlakukan sebagai permintaan yang gagal. |
Coba
/api/sd/cme/overviewSebagianstring — Coin symbol. `BTC`, `ETH`, `SOL` and `XRP` have CME products; other valid symbols return 200 with `meta.quality = "UNAVAILABLE"`.
https://www.coinboss.com/api/sd/cme/overview?coin=BTCLainnya di kategori ini
- Posisi CFTC (futures kripto CME) /api/sd/cme/cot
- Ikhtisar futures CME /api/sd/cme/overview
- Commitments of Traders CFTC /api/cftc/cot