Commitments of Traders CFTC

Commitments of Traders CFTC (futures bitcoin / ether CME)

GET/api/cftc/cot

Deret yang lebih lama dan lebih pendek. `/api/sd/cme/cot` memuat seluruh riwayat CFTC per kelas trader dengan pilihan satuan.

Permintaan

Parameter kueri

Nama	Tipe	Wajib	Default	Nilai yang diizinkan	Deskripsi
currency	string	Opsional	BTC	BTC, ETH	Aset dasar; nilai selain ETH dianggap BTC. Contoh: BTC

Contoh permintaan

curl -s "https://www.coinboss.com/api/cftc/cot?currency=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 }`.
currency	string	—	Simbol mata uang / aset.
contract	string	—	Nama dan ukuran kontrak dari kontrak berjangka CME yang dicakup laporan (`CME Bitcoin Futures (5 BTC)` atau `CME Ether Futures (50 ETH)`).
report_date	string	—	Tanggal as-of (YYYY-MM-DD, hari Selasa) laporan CFTC Commitments of Traders terbaru di `series`; dipublikasikan pada hari Jumat berikutnya.
fetched_at	number	ms	Waktu CoinBoss mengambil data dari sumber.
latest	object	—	Catatan terbaru.
latest.date	string	—	Tanggal kalender (UTC).
latest.oi	number	—	Open interest.
latest.dealer_long	number	—	Laporan CFTC: posisi long dealer.
latest.dealer_short	number	—	Laporan CFTC: posisi short dealer.
latest.am_long	number	—	Laporan CFTC: posisi long manajer aset.
latest.am_short	number	—	Laporan CFTC: posisi short manajer aset.
latest.lev_long	number	—	Laporan CFTC: posisi long dana leverage.
latest.lev_short	number	—	Laporan CFTC: posisi short dana leverage.
latest.other_long	number	—	Laporan CFTC: posisi long wajib lapor lainnya.
latest.other_short	number	—	Laporan CFTC: posisi short wajib lapor lainnya.
latest.nonrept_long	number	—	Laporan CFTC: posisi long tidak wajib lapor.
latest.nonrept_short	number	—	Laporan CFTC: posisi short tidak wajib lapor.
latest.traders	number	—	Jumlah trader.
prev	object	—	Nilai sebelumnya (baseline).
prev.date	string	—	Tanggal kalender (UTC).
prev.oi	number	—	Open interest.
prev.dealer_long	number	—	Laporan CFTC: posisi long dealer.
prev.dealer_short	number	—	Laporan CFTC: posisi short dealer.
prev.am_long	number	—	Laporan CFTC: posisi long manajer aset.
prev.am_short	number	—	Laporan CFTC: posisi short manajer aset.
prev.lev_long	number	—	Laporan CFTC: posisi long dana leverage.
prev.lev_short	number	—	Laporan CFTC: posisi short dana leverage.
prev.other_long	number	—	Laporan CFTC: posisi long wajib lapor lainnya.
prev.other_short	number	—	Laporan CFTC: posisi short wajib lapor lainnya.
prev.nonrept_long	number	—	Laporan CFTC: posisi long tidak wajib lapor.
prev.nonrept_short	number	—	Laporan CFTC: posisi short tidak wajib lapor.
prev.traders	number	—	Jumlah trader.
series	array	—	Deret waktu.
series[]	object	—	Deret waktu.
series[].date	string	—	Tanggal kalender (UTC).
series[].oi	number	—	Open interest.
series[].dealer_long	number	—	Laporan CFTC: posisi long dealer.
series[].dealer_short	number	—	Laporan CFTC: posisi short dealer.
series[].am_long	number	—	Laporan CFTC: posisi long manajer aset.
series[].am_short	number	—	Laporan CFTC: posisi short manajer aset.
series[].lev_long	number	—	Laporan CFTC: posisi long dana leverage.
series[].lev_short	number	—	Laporan CFTC: posisi short dana leverage.
series[].other_long	number	—	Laporan CFTC: posisi long wajib lapor lainnya.
series[].other_short	number	—	Laporan CFTC: posisi short wajib lapor lainnya.
series[].nonrept_long	number	—	Laporan CFTC: posisi long tidak wajib lapor.
series[].nonrept_short	number	—	Laporan CFTC: posisi short tidak wajib lapor.
series[].traders	number	—	Jumlah trader.

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

Contoh respons

/api/cftc/cot?currency=BTC · Respons nyata yang direkam 2026-11-13 03:58:26 UTC. Array dan map yang panjang dipersingkat untuk tampilan: series berisi 448 item.

{
- "success": true,
- "currency": "BTC",
- "contract": "CME Bitcoin Futures (5 BTC)",
- "report_date": "2026-11-03",
- "fetched_at": 1794536904404,
- "latest": {
  - "date": "2026-11-03",
  - "oi": 17527,
  - "dealer_long": 6027,
  - "dealer_short": 5548,
  - "am_long": 4379,
  - "am_short": 1976,
  - "lev_long": 5114,
  - "lev_short": 7705,
  - "other_long": 124,
  - "other_short": 308,
  - "nonrept_long": 762,
  - "nonrept_short": 869,
  - "traders": 105
  },
- "prev": {
  - "date": "2026-10-27",
  - "oi": 20791,
  - "dealer_long": 6257,
  - "dealer_short": 5001,
  - "am_long": 4743,
  - "am_short": 1989,
  - "lev_long": 5887,
  - "lev_short": 9866,
  - "other_long": 94,
  - "other_short": 285,
  - "nonrept_long": 1002,
  - "nonrept_short": 842,
  - "traders": 106
  },
- "series": [
  - { … 13 },
  - { … 13 }
  ]
}

Detail

Autentikasi: Tidak ada. Endpoint publik.
Batas permintaan: 1200 permintaan per menit per IP
Cache server: 10m
Mikro-cache edge: 10s
Frekuensi pembaruan: saat diminta, di-cache 6 jam; laporan bersifat mingguan (posisi hari Selasa, dipublikasikan hari Jumat)
Jendela: seluruh riwayat mingguan
Sumber data: Posisi futures Bitcoin dan Ether CME menurut kategori trader dari data terbuka resmi Commitments of Traders milik CFTC.
Cakupan bursa: `currency` = BTC (default) atau ETH; hanya kontrak CME standar (kontrak mikro tidak disertakan); kategori: dealer, manajer aset, dana leverage, wajib lapor lainnya, tidak wajib lapor.
Pengurutan: tanggal laporan, menaik
Satuan: contracts (CME Bitcoin = 5 BTC, CME Ether = 50 ETH per contract)
Stempel waktu: Milidetik epoch Unix (UTC) kecuali deskripsi kolom menyatakan lain
Format respons: json
Stabilitas: Stabil

Status langsung

TersediaDiperiksa 2026-11-13 03:58:26 UTCHTTP 2007 msSkema sesuaiTitik data terbaru berusia 10.2d

Ketersediaan, 30 hari terakhir

100% dari 409 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

GET/api/cftc/cotTersedia

Parameter

currency

string · default BTC — Underlying; anything other than ETH is BTC.

URL permintaanhttps://www.coinboss.com/api/cftc/cot?currency=BTC

Pilih endpoint lalu tekan “Kirim permintaan”. Respons, header, dan waktu tempuhnya akan muncul di sini.

Posisi CFTC (futures kripto CME) /api/sd/cme/cot
Ikhtisar futures CME /api/sd/cme/overview
Commitments of Traders CFTC /api/cftc/cot