CFTC Commitments of Traders

CFTC Commitments of Traders (Bitcoin- / Ether-Futures der CME)

GET/api/cftc/cot

Frühere, kürzere Reihe. `/api/sd/cme/cot` enthält die vollständige CFTC-Historie je Händlerklasse mit Auswahl der Einheit.

Anfrage

Query-Parameter

Name	Typ	Erforderlich	Standard	Zulässige Werte	Beschreibung
currency	string	Optional	BTC	BTC, ETH	Basiswert; alles außer ETH gilt als BTC. Beispiel: BTC

Beispielanfrage

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

Antwortfelder

Die Feldtabelle wird aus echten Antworten erzeugt und führt daher genau das auf, was der Endpunkt zurückgibt. In Pfaden steht a[] für Array-Elemente und {*} für Objekte, deren Schlüssel ein dynamischer Name ist, etwa ein Coin oder eine Börse.

Feld	Typ	Einheit	Beschreibung
success	boolean	—	true, wenn die Anfrage erfolgreich war. Im Fehlerfall lautet der Body `{ success: false, code, error, request_id }`.
currency	string	—	Währungs- / Asset-Symbol.
contract	string	—	Name und Kontraktgröße des CME-Futures-Kontrakts, den der Bericht abdeckt (`CME Bitcoin Futures (5 BTC)` oder `CME Ether Futures (50 ETH)`).
report_date	string	—	Stichtag (YYYY-MM-DD, ein Dienstag) des neuesten CFTC-Berichts „Commitments of Traders“ in `series`; veröffentlicht am darauffolgenden Freitag.
fetched_at	number	ms	Zeitpunkt, zu dem CoinBoss die Daten von der Quelle abgerufen hat.
latest	object	—	Jüngster Datensatz.
latest.date	string	—	Kalenderdatum (UTC).
latest.oi	number	—	Open Interest.
latest.dealer_long	number	—	CFTC-Bericht: Long-Positionen der Händler.
latest.dealer_short	number	—	CFTC-Bericht: Short-Positionen der Händler.
latest.am_long	number	—	CFTC-Bericht: Long-Positionen der Vermögensverwalter.
latest.am_short	number	—	CFTC-Bericht: Short-Positionen der Vermögensverwalter.
latest.lev_long	number	—	CFTC-Bericht: Long-Positionen der gehebelten Fonds.
latest.lev_short	number	—	CFTC-Bericht: Short-Positionen der gehebelten Fonds.
latest.other_long	number	—	CFTC-Bericht: Long-Positionen der sonstigen Meldepflichtigen.
latest.other_short	number	—	CFTC-Bericht: Short-Positionen der sonstigen Meldepflichtigen.
latest.nonrept_long	number	—	CFTC-Bericht: Long-Positionen der nicht Meldepflichtigen.
latest.nonrept_short	number	—	CFTC-Bericht: Short-Positionen der nicht Meldepflichtigen.
latest.traders	number	—	Anzahl der Händler.
prev	object	—	Vorheriger Wert (Vergleichsbasis).
prev.date	string	—	Kalenderdatum (UTC).
prev.oi	number	—	Open Interest.
prev.dealer_long	number	—	CFTC-Bericht: Long-Positionen der Händler.
prev.dealer_short	number	—	CFTC-Bericht: Short-Positionen der Händler.
prev.am_long	number	—	CFTC-Bericht: Long-Positionen der Vermögensverwalter.
prev.am_short	number	—	CFTC-Bericht: Short-Positionen der Vermögensverwalter.
prev.lev_long	number	—	CFTC-Bericht: Long-Positionen der gehebelten Fonds.
prev.lev_short	number	—	CFTC-Bericht: Short-Positionen der gehebelten Fonds.
prev.other_long	number	—	CFTC-Bericht: Long-Positionen der sonstigen Meldepflichtigen.
prev.other_short	number	—	CFTC-Bericht: Short-Positionen der sonstigen Meldepflichtigen.
prev.nonrept_long	number	—	CFTC-Bericht: Long-Positionen der nicht Meldepflichtigen.
prev.nonrept_short	number	—	CFTC-Bericht: Short-Positionen der nicht Meldepflichtigen.
prev.traders	number	—	Anzahl der Händler.
series	array	—	Zeitreihe.
series[]	object	—	Zeitreihe.
series[].date	string	—	Kalenderdatum (UTC).
series[].oi	number	—	Open Interest.
series[].dealer_long	number	—	CFTC-Bericht: Long-Positionen der Händler.
series[].dealer_short	number	—	CFTC-Bericht: Short-Positionen der Händler.
series[].am_long	number	—	CFTC-Bericht: Long-Positionen der Vermögensverwalter.
series[].am_short	number	—	CFTC-Bericht: Short-Positionen der Vermögensverwalter.
series[].lev_long	number	—	CFTC-Bericht: Long-Positionen der gehebelten Fonds.
series[].lev_short	number	—	CFTC-Bericht: Short-Positionen der gehebelten Fonds.
series[].other_long	number	—	CFTC-Bericht: Long-Positionen der sonstigen Meldepflichtigen.
series[].other_short	number	—	CFTC-Bericht: Short-Positionen der sonstigen Meldepflichtigen.
series[].nonrept_long	number	—	CFTC-Bericht: Long-Positionen der nicht Meldepflichtigen.
series[].nonrept_short	number	—	CFTC-Bericht: Short-Positionen der nicht Meldepflichtigen.
series[].traders	number	—	Anzahl der Händler.

Erzeugt 2026-11-11 23:00 UTC aus 1 echten Antworten.

Beispielantwort

/api/cftc/cot?currency=BTC · Echte Antwort, erfasst 2026-11-13 03:52:57 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: series hatte 448 Elemente.

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

Details

Authentifizierung: Keine. Öffentlicher Endpunkt.
Rate-Limit: 1200 Anfragen pro Minute und IP
Server-Cache: 10m
Edge-Micro-Cache: 10s
Aktualisierungsintervall: bei Anfrage, 6 Stunden im Cache; der Bericht erscheint wöchentlich (Positionen vom Dienstag, Veröffentlichung am Freitag)
Zeitfenster: vollständige Wochenhistorie
Datenquellen: Positionierung in Bitcoin- und Ether-Futures der CME nach Händlerkategorie aus den offiziellen Open Data der CFTC zu den Commitments of Traders.
Börsenabdeckung: `currency` = BTC (Standard) oder ETH; nur Standard-CME-Kontrakte (Micro-Kontrakte nicht enthalten); Kategorien: dealer, asset manager, leveraged money, other reportable, non-reportable.
Sortierung: Berichtsstichtag aufsteigend
Einheiten: contracts (CME Bitcoin = 5 BTC, CME Ether = 50 ETH per contract)
Zeitstempel: Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
Antwortformat: json
Stabilität: Stabil

Live-Status

VerfügbarGeprüft 2026-11-13 03:52:57 UTCHTTP 2003 msSchema stimmt übereinNeuester Datenpunkt 10.2d alt

Verfügbarkeit, letzte 30 Tage

100 % von 408 Prüfungen bestanden

Fehler

Fehlgeschlagene Aufrufe haben auf jedem Endpunkt denselben Aufbau. Die vollständige Liste steht auf der Fehlerseite. Fehler und Rate-Limits →

Code	HTTP	Bedeutung	Empfohlene Reaktion
INVALID_PARAM	400	Ein erforderlicher Parameter fehlt oder ein Wert wird nicht akzeptiert. `param` nennt den Parameter, sofern er bekannt ist.	Nicht unverändert wiederholen; die Anfrage korrigieren.
UNAUTHORIZED	401	Der Header `CB-API-KEY` wurde gesendet, der Schlüssel ist jedoch unbekannt oder widerrufen. Öffentliche Daten erfordern keinen Schlüssel – lassen Sie den Header weg oder verwenden Sie einen gültigen Schlüssel.	Nicht unverändert wiederholen.
FORBIDDEN	403	Die Route gehört nicht zur öffentlichen API (intern oder nur für Konten).	Nicht wiederholen.
NOT_FOUND	404	Unbekannte Route, oder der angefragte Coin / die Börse / der Fonds existiert nicht.	Nicht wiederholen; Pfad und Kennungen mit dem Katalog abgleichen.
RATE_LIMITED	429	Mehr Anfragen, als das Limit pro Minute zulässt. `Retry-After` gibt die Wartezeit in Sekunden an.	`Retry-After` abwarten, dann mit Backoff wiederholen.
INTERNAL	500	Unerwarteter Serverfehler. Die Meldung ist bewusst allgemein gehalten; geben Sie `request_id` an, wenn Sie den Fehler melden.	Einmal nach einigen Sekunden wiederholen; wenn der Fehler bestehen bleibt, mit der Request-ID melden.
UPSTREAM_FAILED	503	Die Datenquelle hinter diesem Endpunkt hat nicht rechtzeitig geantwortet. Es werden ersatzweise keine veralteten oder stellvertretenden Zahlen zurückgegeben.	Mit Backoff wiederholen; die Statusseite prüfen.
UNAVAILABLE	501 / 503	Der Datensatz ist vorübergehend nicht bereit (Cache wird aufgewärmt), oder der Endpunkt hat noch keine rechtmäßige öffentliche Quelle.	Später wiederholen; der Katalog kennzeichnet Endpunkte, die konzeptbedingt nicht verfügbar sind.
REQUEST_FAILED	200	Einige ältere Endpunkte antworten mit HTTP 200 und `success: false`. Prüfen Sie immer `success`, nicht nur den HTTP-Status.	Hängt von der Meldung ab; als fehlgeschlagene Anfrage behandeln.

Ausprobieren

GET/api/cftc/cotVerfügbar

Parameter

currency

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

Anfrage-URLhttps://www.coinboss.com/api/cftc/cot?currency=BTC

Wählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.

CFTC-Positionierung (CME-Krypto-Futures) /api/sd/cme/cot
Übersicht der CME-Futures /api/sd/cme/overview
CFTC Commitments of Traders /api/cftc/cot