Volume 24j—Open Interest—Likuidasi 24j$1.36BLong/Short 24j—Dominasi BTC—Dominasi ETH—
Aplikasi
Bahasa ▾
Rp IDR ▾
/api/sd/cme/cot
GETTersediaFRESH

Posisi CFTC (futures kripto CME)

Deret mingguan Commitments of Traders untuk futures kripto CME: posisi long, short, spread, dan bersih dari dealer, manajer aset, leveraged fund, pelapor lainnya, dan non-pelapor.

GET/api/sd/cme/cot

Permintaan

Parameter kueri

NamaTipeWajibDefaultNilai yang diizinkanDeskripsi
coinstringWajib——Simbol koin: `BTC`, `ETH`, `SOL`, atau `XRP`. Contoh: BTC
rangestringOpsional1y3m, 6m, 1y, 3y, allRentang waktu ke belakang; satu titik per laporan mingguan.
unitstringOpsionalcoincoin, contracts, usdSatuan kolom posisi. `contracts` memerlukan `contract`, karena kontrak dengan ukuran berbeda tidak dapat dijumlahkan.
contractstringOpsional——Satu produk CME untuk koin tersebut (misalnya `BTC` atau `MBT`). Default: semua produk koin tersebut, dikonversi ke koin dan dijumlahkan.

Contoh permintaan

curl -s "https://www.coinboss.com/api/sd/cme/cot?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).
rangestring—Rentang waktu ke belakang yang diterapkan.
unitstring—Satuan kolom posisi: `coin`, `contracts`, atau `usd`.
contractnull—Produk CME yang dipilih, atau `null` untuk semua produk koin tersebut.
report_datestring—Tanggal as-of laporan CFTC (biasanya hari Selasa).
contractsarray—Produk CME yang disertakan.
contracts[]string—Produk CME yang disertakan.
multipliersobject—Jumlah koin per kontrak, per produk (kuncinya adalah kode produk). kunci dinamis: BTC,MBT
multipliers.{*}number—Jumlah koin per kontrak, per produk (kuncinya adalah kode produk).
pointsnumber—Titik deret, yang terlama lebih dulu.
latestobject—Laporan mingguan terbaru.
latest.datestring—Tanggal as-of laporan mingguan.
latest.contractsarray—Produk CME yang disertakan.
latest.contracts[]string—Produk CME yang disertakan.
latest.oinumber—Total open interest laporan, dalam satuan yang dipilih.
latest.dealer_longnumber—Posisi long dealer / perantara.
latest.dealer_shortnumber—Posisi short dealer / perantara.
latest.dealer_spreadnumber—Posisi long dan short dealer yang saling hapus; tidak termasuk dalam long maupun short.
latest.dealer_netnumber—Dealer: long − short.
latest.asset_mgr_longnumber—Posisi long manajer aset / institusional.
latest.asset_mgr_shortnumber—Posisi short manajer aset / institusional.
latest.asset_mgr_spreadnumber—Posisi manajer aset yang saling hapus; tidak termasuk dalam long maupun short.
latest.asset_mgr_netnumber—Manajer aset: long − short.
latest.lev_money_longnumber—Posisi long dana leverage.
latest.lev_money_shortnumber—Posisi short dana leverage.
latest.lev_money_spreadnumber—Posisi dana leverage yang saling hapus; tidak termasuk dalam long maupun short.
latest.lev_money_netnumber—Dana leverage: long − short.
latest.other_rept_longnumber—Posisi long trader wajib lapor lainnya.
latest.other_rept_shortnumber—Posisi short trader wajib lapor lainnya.
latest.other_rept_spreadnumber—Posisi trader wajib lapor lainnya yang saling hapus; tidak termasuk dalam long maupun short.
latest.other_rept_netnumber—Wajib lapor lainnya: long − short.
latest.nonrept_longnumber—Posisi long trader tidak wajib lapor (kecil).
latest.nonrept_shortnumber—Posisi short trader tidak wajib lapor (kecil).
latest.nonrept_netnumber—Tidak wajib lapor: long − short.
seriesarray—Titik mingguan, yang terlama lebih dulu.
series[]object—Titik mingguan, yang terlama lebih dulu.
series[].datestring—Tanggal as-of laporan mingguan.
series[].contractsarray—Produk CME yang disertakan.
series[].contracts[]string—Produk CME yang disertakan.
series[].oinumber—Total open interest laporan, dalam satuan yang dipilih.
series[].dealer_longnumber—Posisi long dealer / perantara.
series[].dealer_shortnumber—Posisi short dealer / perantara.
series[].dealer_spreadnumber—Posisi long dan short dealer yang saling hapus; tidak termasuk dalam long maupun short.
series[].dealer_netnumber—Dealer: long − short.
series[].asset_mgr_longnumber—Posisi long manajer aset / institusional.
series[].asset_mgr_shortnumber—Posisi short manajer aset / institusional.
series[].asset_mgr_spreadnumber—Posisi manajer aset yang saling hapus; tidak termasuk dalam long maupun short.
series[].asset_mgr_netnumber—Manajer aset: long − short.
series[].lev_money_longnumber—Posisi long dana leverage.
series[].lev_money_shortnumber—Posisi short dana leverage.
series[].lev_money_spreadnumber—Posisi dana leverage yang saling hapus; tidak termasuk dalam long maupun short.
series[].lev_money_netnumber—Dana leverage: long − short.
series[].other_rept_longnumber—Posisi long trader wajib lapor lainnya.
series[].other_rept_shortnumber—Posisi short trader wajib lapor lainnya.
series[].other_rept_spreadnumber—Posisi trader wajib lapor lainnya yang saling hapus; tidak termasuk dalam long maupun short.
series[].other_rept_netnumber—Wajib lapor lainnya: long − short.
series[].nonrept_longnumber—Posisi long trader tidak wajib lapor (kecil).
series[].nonrept_shortnumber—Posisi short trader tidak wajib lapor (kecil).
series[].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. kosong pada sampel yang dipakai untuk menghasilkan tabel ini
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.valuestring—Catatan rumus untuk `value`, teks biasa.
method.categoriesstring—Catatan rumus untuk `categories`, teks biasa.
method.identitystring—Catatan rumus untuk `identity`, teks biasa.
method.pricestring—Catatan rumus untuk `price`, teks biasa.
method.is_stalestring—Catatan rumus untuk `is_stale`, 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_atnumbermsStempel waktu yang diberikan sumber untuk data tersebut.
meta.received_atnumbermsWaktu 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.
latest.pricenumberUSDHarga yang dipakai untuk konversi ke USD. bisa tidak ada
latest.price_srcstring—Asal `price`: harga penyelesaian bulan terdekat CME jika dikumpulkan, selain itu harga acuan harian yang diberi label. bisa tidak ada
series[].pricenumberUSDHarga yang dipakai untuk konversi ke USD. bisa tidak ada
series[].price_srcstring—Asal `price`: harga penyelesaian bulan terdekat CME jika dikumpulkan, selain itu harga acuan harian yang diberi label. bisa tidak ada

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

Contoh respons

/api/sd/cme/cot?coin=BTC · Respons nyata yang direkam 2026-11-13 03:58:25 UTC. Array dan map yang panjang dipersingkat untuk tampilan: series berisi 51 item.

  • {
    • "success": true,
    • "schema": "coinboss.sd.cme/1",
    • "now": 1794542305751,
    • "coin": "BTC",
    • "range": "1y",
    • "unit": "coin",
    • "contract": null,
    • "report_date": "2026-11-03",
    • "contracts": [
      • "BTC",
      • "MBT"
      ],
    • "multipliers": {
      • "BTC": 5,
      • "MBT": 0.1
      },
    • "points": 51,
    • "latest": {
      • "date": "2026-11-03",
      • "contracts": [ … 2 ],
      • "oi": 89918.8,
      • "dealer_long": 30263.2,
      • "dealer_short": 27953.8,
      • "dealer_spread": 2450,
      • "dealer_net": 2309.4,
      • "asset_mgr_long": 22052.2,
      • "asset_mgr_short": 9925.7,
      • "asset_mgr_spread": 935,
      • "asset_mgr_net": 12126.5,
      • "lev_money_long": 26616.8,
      • "lev_money_short": 40103.2,
      • "lev_money_spread": 2148,
      • "lev_money_net": -13486.4,
      • "other_rept_long": 1111.6,
      • "other_rept_short": 1787.6,
      • "other_rept_spread": 99.6,
      • "other_rept_net": -676,
      • "nonrept_long": 4242.4,
      • "nonrept_short": 4515.9,
      • "nonrept_net": -273.5
      },
    • "series": [
      • { … 22 },
      • { … 22 }
      ],
    • "coverage": {
      • "included_exchanges": [ … 1 ],
      • "unavailable": [],
      • "stale_excluded": []
      },
    • "method": {
      • "value": "CFTC Commitments of Traders, Traders in Financial Futures, futures only. Each series point is one weekly report (as-of Tuesday). unit=coin: contracts x multipli…",
      • "categories": "dealer = Dealer/Intermediary, asset_mgr = Asset Manager/Institutional, lev_money = Leveraged Funds, other_rept = Other Reportables, nonrept = Non-reportable; *_…",
      • "identity": "oi = sum of the four category longs + four category spreads + nonrept_long (and the same on the short side)",
      • "price": "unit=usd only: CME front-month final settlement of the report date when collected, otherwise reference spot price (price_src per point); null price gives null v…",
      • "is_stale": "now is more than 10 days past the scheduled release of the latest stored report (release = report_date + 3 days, 21:30 UTC upper bound for Friday 15:30 ET)"
      },
    • "meta": {
      • "schema": "coinboss.sd.cme/1",
      • "source": [ … 1 ],
      • "observed_at": 1793664000000,
      • "received_at": 1794504008901,
      • "fetched_at": 1794542305751,
      • "window": "1y",
      • "quality": "FRESH",
      • "is_stale": false,
      • "cache_ttl_s": 300,
      • "fallback": "on collector failure the last stored weekly report is served with its real report_date; flagged is_stale=true once 10 days have passed since its scheduled relea…"
      }
    }

Sampel terverifikasi

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

ParameterHTTPLatensiHasil
coin=ETH&unit=usd2007 msLolos PARTIAL
coin=BTC&range=all20015 msLolos FRESH
coin=BTC&unit=contracts4001 msLolos mengembalikan error yang diharapkan

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

Detail

Autentikasi
Tidak ada. Endpoint publik.
Batas permintaan
1200 permintaan per menit per IP
Cache server
5m
Mikro-cache edge
10s
Frekuensi pembaruan
Mingguan. Tanggal laporan biasanya hari Selasa dan CFTC memublikasikannya pada hari Jumat; kolektor memeriksa tiga kali per hari.
Jendela
3m / 6m / 1y / 3y / all, titik mingguan.
Sumber data
Laporan CFTC Commitments of Traders, Traders in Financial Futures (hanya futures), dikumpulkan dan disimpan oleh CoinBoss (sd_cme_cot_weekly).
Cakupan bursa
BTC sejak 2018-04-10, ETH sejak 2021-04-06; SOL dan XRP sejak pencatatannya di CME. Minggu ketika salah satu produk koin tersebut tidak ada dalam laporan ditandai PARTIAL.
Paginasi
Tanpa paginasi; `range` membatasi jumlah titik.
Pengurutan
Tanggal laporan, menaik.
Satuan
Positions in coin by default (contracts × multiplier), or in contracts / USD with `unit`. With `unit=usd` each point carries the reference `price` and `price_src` used.
Metode
net = long − short for every trader class. `*_spread` is the offsetting long-and-short position held by the same trader and is not included in long or short. Identity: Σ long + Σ spread + non-reportable long = open interest (and the same on the short side).
Stempel waktu
Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons
json
Stabilitas
Stabil
Tersedia sejak
2026-11-11

Status langsung

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

Ketersediaan, 30 hari terakhir

100% 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/cotTersedia
Parameter

string — Coin symbol: `BTC`, `ETH`, `SOL` or `XRP`.

string · default 1y — Look-back range; one point per weekly report.

string · default coin — Unit of the position fields. `contracts` requires `contract`, because contracts of different size cannot be added.

string — One CME product of the coin (for example `BTC` or `MBT`). Default: all products of the coin, converted to coin and summed.

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