CFTC Commitments of Traders

CFTC Commitments of Traders (CME bitcoin / ether vadeli işlemleri)

GET/api/cftc/cot

Daha eski ve daha kısa bir seri. `/api/sd/cme/cot` birim seçimiyle birlikte trader sınıfı bazında tam CFTC geçmişini sunar.

İstek

Sorgu parametreleri

Ad	Tür	Zorunlu	Varsayılan	İzin verilen değerler	Açıklama
currency	string	İsteğe bağlı	BTC	BTC, ETH	Dayanak varlık; ETH dışındaki her değer BTC sayılır. Örnek: BTC

Örnek istek

curl -s "https://www.coinboss.com/api/cftc/cot?currency=BTC"

Yanıt alanları

Alan tablosu gerçek yanıtlardan üretilir; dolayısıyla uç noktanın tam olarak ne döndürdüğünü listeler. Yollarda a[] dizi öğelerini, {*} ise coin veya borsa gibi dinamik bir adla anahtarlanan nesneleri gösterir.

Alan	Tür	Birim	Açıklama
success	boolean	—	İstek başarılıysa true. Başarısızlık durumunda gövde `{ success: false, code, error, request_id }` olur.
currency	string	—	Para birimi / varlık sembolü.
contract	string	—	Raporun kapsadığı CME vadeli sözleşmesinin adı ve sözleşme büyüklüğü (`CME Bitcoin Futures (5 BTC)` veya `CME Ether Futures (50 ETH)`).
report_date	string	—	`series` içindeki en son CFTC Commitments of Traders raporunun veri tarihi (YYYY-MM-DD, bir salı günü); rapor izleyen cuma günü yayımlanır.
fetched_at	number	ms	CoinBoss'un veriyi kaynaktan getirdiği zaman.
latest	object	—	En son kayıt.
latest.date	string	—	Takvim tarihi (UTC).
latest.oi	number	—	Açık pozisyon.
latest.dealer_long	number	—	CFTC raporu: aracı kurum (dealer) long pozisyonları.
latest.dealer_short	number	—	CFTC raporu: aracı kurum (dealer) short pozisyonları.
latest.am_long	number	—	CFTC raporu: varlık yöneticisi long pozisyonları.
latest.am_short	number	—	CFTC raporu: varlık yöneticisi short pozisyonları.
latest.lev_long	number	—	CFTC raporu: kaldıraçlı fon long pozisyonları.
latest.lev_short	number	—	CFTC raporu: kaldıraçlı fon short pozisyonları.
latest.other_long	number	—	CFTC raporu: diğer raporlama yükümlülerinin long pozisyonları.
latest.other_short	number	—	CFTC raporu: diğer raporlama yükümlülerinin short pozisyonları.
latest.nonrept_long	number	—	CFTC raporu: raporlama yükümlüsü olmayanların long pozisyonları.
latest.nonrept_short	number	—	CFTC raporu: raporlama yükümlüsü olmayanların short pozisyonları.
latest.traders	number	—	Trader sayısı.
prev	object	—	Önceki değer (referans).
prev.date	string	—	Takvim tarihi (UTC).
prev.oi	number	—	Açık pozisyon.
prev.dealer_long	number	—	CFTC raporu: aracı kurum (dealer) long pozisyonları.
prev.dealer_short	number	—	CFTC raporu: aracı kurum (dealer) short pozisyonları.
prev.am_long	number	—	CFTC raporu: varlık yöneticisi long pozisyonları.
prev.am_short	number	—	CFTC raporu: varlık yöneticisi short pozisyonları.
prev.lev_long	number	—	CFTC raporu: kaldıraçlı fon long pozisyonları.
prev.lev_short	number	—	CFTC raporu: kaldıraçlı fon short pozisyonları.
prev.other_long	number	—	CFTC raporu: diğer raporlama yükümlülerinin long pozisyonları.
prev.other_short	number	—	CFTC raporu: diğer raporlama yükümlülerinin short pozisyonları.
prev.nonrept_long	number	—	CFTC raporu: raporlama yükümlüsü olmayanların long pozisyonları.
prev.nonrept_short	number	—	CFTC raporu: raporlama yükümlüsü olmayanların short pozisyonları.
prev.traders	number	—	Trader sayısı.
series	array	—	Zaman serisi.
series[]	object	—	Zaman serisi.
series[].date	string	—	Takvim tarihi (UTC).
series[].oi	number	—	Açık pozisyon.
series[].dealer_long	number	—	CFTC raporu: aracı kurum (dealer) long pozisyonları.
series[].dealer_short	number	—	CFTC raporu: aracı kurum (dealer) short pozisyonları.
series[].am_long	number	—	CFTC raporu: varlık yöneticisi long pozisyonları.
series[].am_short	number	—	CFTC raporu: varlık yöneticisi short pozisyonları.
series[].lev_long	number	—	CFTC raporu: kaldıraçlı fon long pozisyonları.
series[].lev_short	number	—	CFTC raporu: kaldıraçlı fon short pozisyonları.
series[].other_long	number	—	CFTC raporu: diğer raporlama yükümlülerinin long pozisyonları.
series[].other_short	number	—	CFTC raporu: diğer raporlama yükümlülerinin short pozisyonları.
series[].nonrept_long	number	—	CFTC raporu: raporlama yükümlüsü olmayanların long pozisyonları.
series[].nonrept_short	number	—	CFTC raporu: raporlama yükümlüsü olmayanların short pozisyonları.
series[].traders	number	—	Trader sayısı.

Üretilme zamanı: 2026-11-11 23:00 UTC; kaynak: 1 gerçek yanıt.

Örnek yanıt

/api/cftc/cot?currency=BTC · Gerçek yanıt, yakalanma zamanı: 2026-11-13 03:52:57 UTC. Uzun diziler ve eşlemeler görüntüleme için kısaltılmıştır: series: 448 öğe içeriyordu.

{
- "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 }
  ]
}

Ayrıntılar

Kimlik doğrulama: Yok. Herkese açık uç nokta.
İstek sınırı: IP başına dakikada 1200 istek
Sunucu önbelleği: 10m
Edge mikro önbelleği: 10s
Güncelleme sıklığı: istek anında, 6 saat önbelleğe alınır; rapor haftalıktır (salı pozisyonları, cuma günü yayımlanır)
Pencere: tam haftalık geçmiş
Veri kaynakları: CFTC'nin resmî Commitments of Traders açık verilerine göre, trader kategorisi bazında CME Bitcoin ve Ether vadeli işlem pozisyonları.
Borsa kapsamı: `currency` = BTC (varsayılan) veya ETH; yalnızca standart CME sözleşmeleri (mikro sözleşmeler dahil değildir); kategoriler: aracı kurum (dealer), varlık yöneticisi, kaldıraçlı fon, diğer raporlama yükümlüsü, raporlama yükümlüsü olmayan.
Sıralama: rapor tarihi, artan
Birimler: contracts (CME Bitcoin = 5 BTC, CME Ether = 50 ETH per contract)
Zaman damgaları: Alan açıklamasında aksi belirtilmedikçe Unix epoch milisaniyesi (UTC)
Yanıt biçimi: json
Kararlılık: Kararlı

Canlı durum

KullanılabilirKontrol: 2026-11-13 03:52:57 UTCHTTP 2003 msŞema eşleşiyorEn yeni veri noktası 10.2d öncesine ait

Erişilebilirlik, son 30 gün

408 kontrolde başarı oranı: %100

Hatalar

Başarısız çağrılar tüm uç noktalarda aynı yapıyı paylaşır. Tam liste hatalar sayfasındadır. Hatalar ve istek sınırları →

Kod	HTTP	Anlamı	Ne yapmalı
INVALID_PARAM	400	Zorunlu bir parametre eksik ya da bir değer kabul edilmiyor. Biliniyorsa `param` parametrenin adını verir.	Değiştirmeden yeniden denemeyin; isteği düzeltin.
UNAUTHORIZED	401	`CB-API-KEY` başlığı gönderildi, ancak anahtar bilinmiyor veya iptal edilmiş. Herkese açık veriler anahtar gerektirmez; başlığı kaldırın veya geçerli bir anahtar kullanın.	Değiştirmeden yeniden denemeyin.
FORBIDDEN	403	Bu rota herkese açık API'nin parçası değildir (dahilî veya yalnızca hesaba özel).	Yeniden denemeyin.
NOT_FOUND	404	Bilinmeyen rota ya da istenen coin / borsa / fon yok.	Yeniden denemeyin; yolu ve tanımlayıcıları katalogla karşılaştırarak kontrol edin.
RATE_LIMITED	429	Dakika başına sınırdan fazla istek gönderildi. `Retry-After`, beklenecek saniye sayısını verir.	`Retry-After` süresi kadar bekleyin, ardından artan beklemeyle yeniden deneyin.
INTERNAL	500	Beklenmeyen sunucu hatası. Mesaj bilinçli olarak geneldir; hatayı bildirirken `request_id` değerini belirtin.	Birkaç saniye sonra bir kez yeniden deneyin; sorun sürerse istek kimliğiyle birlikte bildirin.
UPSTREAM_FAILED	503	Bu uç noktanın arkasındaki veri kaynağı zamanında yanıt vermedi. Yerine eskimiş veya ikame rakamlar döndürülmez.	Artan beklemeyle yeniden deneyin; durum sayfasını kontrol edin.
UNAVAILABLE	501 / 503	Veri kümesi geçici olarak hazır değil (önbellek ısınıyor) ya da uç noktanın henüz yasal bir herkese açık kaynağı yok.	Daha sonra yeniden deneyin; katalog, tasarım gereği mevcut olmayan uç noktaları işaretler.
REQUEST_FAILED	200	Bazı eski uç noktalar HTTP 200 ile `success: false` yanıtı verir. Yalnızca HTTP durumunu değil, her zaman `success` değerini de kontrol edin.	Mesaja bağlıdır; başarısız bir istek olarak ele alın.

Deneyin

GET/api/cftc/cotKullanılabilir

Parametreler

currency

string · varsayılan BTC — Underlying; anything other than ETH is BTC.

İstek URL'sihttps://www.coinboss.com/api/cftc/cot?currency=BTC

Bir uç nokta seçip “İstek gönder” düğmesine basın. Yanıt, başlıklar ve süre bilgisi burada görünür.

CFTC pozisyonlanması (CME kripto vadeli işlemleri) /api/sd/cme/cot
CME vadeli işlemler özeti /api/sd/cme/overview
CFTC Commitments of Traders /api/cftc/cot