GETVerfügbarFRESH
CFTC-Positionierung (CME-Krypto-Futures)
Wöchentliche Commitments-of-Traders-Reihe für CME-Krypto-Futures: Long-, Short-, Spread- und Nettopositionen von Dealern, Asset-Managern, Leveraged Funds, sonstigen meldepflichtigen und nicht meldepflichtigen Händlern.
GET
/api/sd/cme/cotAnfrage
Query-Parameter
| Name | Typ | Erforderlich | Standard | Zulässige Werte | Beschreibung |
|---|---|---|---|---|---|
| coin | string | Erforderlich | — | — | Coin-Symbol: `BTC`, `ETH`, `SOL` oder `XRP`. Beispiel: BTC |
| range | string | Optional | 1y | 3m, 6m, 1y, 3y, all | Rückblickzeitraum; ein Punkt je Wochenbericht. |
| unit | string | Optional | coin | coin, contracts, usd | Einheit der Positionsfelder. `contracts` erfordert `contract`, weil Kontrakte unterschiedlicher Größe nicht addiert werden können. |
| contract | string | Optional | — | — | Ein CME-Produkt des Coins (zum Beispiel `BTC` oder `MBT`). Standard: alle Produkte des Coins, in Coins umgerechnet und summiert. |
Beispielanfrage
curl -s "https://www.coinboss.com/api/sd/cme/cot?coin=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 }`. |
| schema | string | — | Schema-ID dieser Antwort. Sie ändert sich nur, wenn ein bestehendes Feld seine Bedeutung oder seinen Typ ändert. |
| now | number | ms | Serverzeit beim Erstellen der Antwort. |
| coin | string | — | Coin-Symbol (Großbuchstaben). |
| range | string | — | Angewendeter Rückblickzeitraum. |
| unit | string | — | Einheit der Positionsfelder: `coin`, `contracts` oder `usd`. |
| contract | null | — | Ausgewähltes CME-Produkt oder `null` für alle Produkte des Coins. |
| report_date | string | — | Stichtag des CFTC-Berichts (in der Regel ein Dienstag). |
| contracts | array | — | Einbezogene CME-Produkte. |
| contracts[] | string | — | Einbezogene CME-Produkte. |
| multipliers | object | — | Coins je Kontrakt, je Produkt (der Schlüssel ist der Produktcode). dynamische Schlüssel: BTC,MBT |
| multipliers.{*} | number | — | Coins je Kontrakt, je Produkt (der Schlüssel ist der Produktcode). |
| points | number | — | Punkte der Reihe, älteste zuerst. |
| latest | object | — | Jüngster Wochenbericht. |
| latest.date | string | — | Stichtag des Wochenberichts. |
| latest.contracts | array | — | Einbezogene CME-Produkte. |
| latest.contracts[] | string | — | Einbezogene CME-Produkte. |
| latest.oi | number | — | Gesamtes Open Interest des Berichts, in der ausgewählten Einheit. |
| latest.dealer_long | number | — | Long-Positionen der Händler / Intermediäre. |
| latest.dealer_short | number | — | Short-Positionen der Händler / Intermediäre. |
| latest.dealer_spread | number | — | Sich ausgleichende Long- und Short-Positionen der Händler; weder in Long noch in Short enthalten. |
| latest.dealer_net | number | — | Händler: long − short. |
| latest.asset_mgr_long | number | — | Long-Positionen der Vermögensverwalter / institutionellen Anleger. |
| latest.asset_mgr_short | number | — | Short-Positionen der Vermögensverwalter / institutionellen Anleger. |
| latest.asset_mgr_spread | number | — | Sich ausgleichende Positionen der Vermögensverwalter; weder in Long noch in Short enthalten. |
| latest.asset_mgr_net | number | — | Vermögensverwalter: long − short. |
| latest.lev_money_long | number | — | Long-Positionen der gehebelten Fonds. |
| latest.lev_money_short | number | — | Short-Positionen der gehebelten Fonds. |
| latest.lev_money_spread | number | — | Sich ausgleichende Positionen der gehebelten Fonds; weder in Long noch in Short enthalten. |
| latest.lev_money_net | number | — | Gehebelte Fonds: long − short. |
| latest.other_rept_long | number | — | Long-Positionen der sonstigen meldepflichtigen Händler. |
| latest.other_rept_short | number | — | Short-Positionen der sonstigen meldepflichtigen Händler. |
| latest.other_rept_spread | number | — | Sich ausgleichende Positionen der sonstigen meldepflichtigen Händler; weder in Long noch in Short enthalten. |
| latest.other_rept_net | number | — | Sonstige Meldepflichtige: long − short. |
| latest.nonrept_long | number | — | Long-Positionen der nicht meldepflichtigen (kleinen) Händler. |
| latest.nonrept_short | number | — | Short-Positionen der nicht meldepflichtigen (kleinen) Händler. |
| latest.nonrept_net | number | — | Nicht Meldepflichtige: long − short. |
| series | array | — | Wöchentliche Punkte, älteste zuerst. |
| series[] | object | — | Wöchentliche Punkte, älteste zuerst. |
| series[].date | string | — | Stichtag des Wochenberichts. |
| series[].contracts | array | — | Einbezogene CME-Produkte. |
| series[].contracts[] | string | — | Einbezogene CME-Produkte. |
| series[].oi | number | — | Gesamtes Open Interest des Berichts, in der ausgewählten Einheit. |
| series[].dealer_long | number | — | Long-Positionen der Händler / Intermediäre. |
| series[].dealer_short | number | — | Short-Positionen der Händler / Intermediäre. |
| series[].dealer_spread | number | — | Sich ausgleichende Long- und Short-Positionen der Händler; weder in Long noch in Short enthalten. |
| series[].dealer_net | number | — | Händler: long − short. |
| series[].asset_mgr_long | number | — | Long-Positionen der Vermögensverwalter / institutionellen Anleger. |
| series[].asset_mgr_short | number | — | Short-Positionen der Vermögensverwalter / institutionellen Anleger. |
| series[].asset_mgr_spread | number | — | Sich ausgleichende Positionen der Vermögensverwalter; weder in Long noch in Short enthalten. |
| series[].asset_mgr_net | number | — | Vermögensverwalter: long − short. |
| series[].lev_money_long | number | — | Long-Positionen der gehebelten Fonds. |
| series[].lev_money_short | number | — | Short-Positionen der gehebelten Fonds. |
| series[].lev_money_spread | number | — | Sich ausgleichende Positionen der gehebelten Fonds; weder in Long noch in Short enthalten. |
| series[].lev_money_net | number | — | Gehebelte Fonds: long − short. |
| series[].other_rept_long | number | — | Long-Positionen der sonstigen meldepflichtigen Händler. |
| series[].other_rept_short | number | — | Short-Positionen der sonstigen meldepflichtigen Händler. |
| series[].other_rept_spread | number | — | Sich ausgleichende Positionen der sonstigen meldepflichtigen Händler; weder in Long noch in Short enthalten. |
| series[].other_rept_net | number | — | Sonstige Meldepflichtige: long − short. |
| series[].nonrept_long | number | — | Long-Positionen der nicht meldepflichtigen (kleinen) Händler. |
| series[].nonrept_short | number | — | Short-Positionen der nicht meldepflichtigen (kleinen) Händler. |
| series[].nonrept_net | number | — | Nicht Meldepflichtige: long − short. |
| coverage | object | — | Was in den Zahlen enthalten ist und was nicht. Vergleichen Sie dies, bevor Sie Summen mit einer anderen Quelle vergleichen. |
| coverage.included_exchanges | array | — | Quellen, deren aktuelle Daten einbezogen sind. |
| coverage.included_exchanges[] | string | — | Quellen, deren aktuelle Daten einbezogen sind. |
| coverage.unavailable | array | — | Quellen, die nicht einbezogen werden konnten, jeweils mit Begründung. Sie werden nie als 0 gezählt. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde |
| coverage.stale_excluded | array | — | Zeilen, die unberücksichtigt bleiben, weil ihre letzte Aktualisierung außerhalb des Aktualitätsfensters liegt. leer in den Stichproben, aus denen diese Tabelle erzeugt wurde |
| method | object | — | Klartextangabe der für diese Antwort verwendeten Formeln, ein Eintrag je Feld. |
| method.value | string | — | Formelhinweis zu `value`, Klartext. |
| method.categories | string | — | Formelhinweis zu `categories`, Klartext. |
| method.identity | string | — | Formelhinweis zu `identity`, Klartext. |
| method.price | string | — | Formelhinweis zu `price`, Klartext. |
| method.is_stale | string | — | Formelhinweis zu `is_stale`, Klartext. |
| meta | object | — | Datenherkunft und Aktualität dieser Antwort. |
| meta.schema | string | — | Schema-ID dieser Antwort. Sie ändert sich nur, wenn ein bestehendes Feld seine Bedeutung oder seinen Typ ändert. |
| meta.source | array | — | Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden. |
| meta.source[] | object | — | Öffentliche Upstream-Endpunkte, von denen die Daten erhoben wurden. |
| meta.source[].exchange | string | — | Börsenkennung (Kleinbuchstaben). |
| meta.source[].endpoint | string | — | Öffentlicher Endpunkt der Quelle, den der Collector liest (zur Datenherkunft angegeben; Clients rufen ihn nie auf). |
| meta.observed_at | number | ms | Von der Quelle für die Daten angegebener Zeitstempel. |
| meta.received_at | number | ms | Zeitpunkt, zu dem der CoinBoss-Collector die Daten empfangen hat. |
| meta.fetched_at | number | ms | Zeitpunkt, zu dem diese Antwort zusammengestellt wurde. |
| meta.window | string | — | Zeitfenster, das die Zahlen abdecken. |
| meta.quality | string | — | FRESH, PARTIAL, STALE, BROKEN oder UNAVAILABLE, beurteilt anhand der Datenzeitstempel und der Abdeckung. |
| meta.is_stale | boolean | — | True, wenn die Daten älter als ihr Aktualitätsfenster sind. |
| meta.cache_ttl_s | number | s | Cache-Lebensdauer dieser Antwort. |
| meta.fallback | string | — | Was der Endpunkt zurückgibt, wenn der Collector oder eine Quelle ausfällt. |
| latest.price | number | USD | Für die USD-Umrechnung verwendeter Preis. kann fehlen |
| latest.price_src | string | — | Woher `price` stammt: CME-Abrechnungspreis des Front-Monats, sofern erhoben, andernfalls ein gekennzeichneter täglicher Referenzpreis. kann fehlen |
| series[].price | number | USD | Für die USD-Umrechnung verwendeter Preis. kann fehlen |
| series[].price_src | string | — | Woher `price` stammt: CME-Abrechnungspreis des Front-Monats, sofern erhoben, andernfalls ein gekennzeichneter täglicher Referenzpreis. kann fehlen |
Erzeugt 2026-11-11 23:00 UTC aus 3 echten Antworten.
Beispielantwort
/api/sd/cme/cot?coin=BTC · Echte Antwort, erfasst 2026-11-13 03:52:57 UTC. Lange Arrays und Maps sind für die Anzeige gekürzt: series hatte 51 Elemente.
- "success"true
- "schema""coinboss.sd.cme/1"
- "now"1794541977237
- "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"
- "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"
- "coverage"
- "included_exchanges"
- "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"
- "observed_at"1793664000000
- "received_at"1794504008901
- "fetched_at"1794541977237
- "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…"
Geprüfte Stichproben
Neben dem obigen Beispiel ruft die Prüfsonde diesen Endpunkt mit den folgenden Parametern auf und prüft jedes Mal das Schema.
| Parameter | HTTP | Latenz | Ergebnis |
|---|---|---|---|
| coin=ETH&unit=usd | 200 | 6 ms | Bestanden PARTIAL |
| coin=BTC&range=all | 200 | 19 ms | Bestanden FRESH |
| coin=BTC&unit=contracts | 400 | 1 ms | Bestanden liefert den erwarteten Fehler |
Geprüft 2026-11-13 03:28:22 UTC
Details
- Authentifizierung
- Keine. Öffentlicher Endpunkt.
- Rate-Limit
- 1200 Anfragen pro Minute und IP
- Server-Cache
- 5m
- Edge-Micro-Cache
- 10s
- Aktualisierungsintervall
- Wöchentlich. Der Berichtsstichtag ist in der Regel Dienstag, und die CFTC veröffentlicht den Bericht am Freitag; der Collector prüft dreimal pro Tag.
- Zeitfenster
- 3m / 6m / 1y / 3y / all, wöchentliche Punkte.
- Datenquellen
- CFTC Commitments of Traders, Bericht Traders in Financial Futures (nur Futures), von CoinBoss erhoben und gespeichert (sd_cme_cot_weekly).
- Börsenabdeckung
- BTC seit 2018-04-10, ETH seit 2021-04-06; SOL und XRP seit ihrem CME-Listing. Eine Woche, in der ein Produkt des Coins im Bericht fehlt, wird als PARTIAL markiert.
- Paginierung
- Keine Paginierung; `range` begrenzt die Anzahl der Punkte.
- Sortierung
- Berichtsstichtag aufsteigend.
- Einheiten
- 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.
- Methode
- 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).
- Zeitstempel
- Unix-Epoche in Millisekunden (UTC), sofern die Feldbeschreibung nichts anderes angibt
- Antwortformat
- json
- Stabilität
- Stabil
- Verfügbar seit
- 2026-11-11
Live-Status
VerfügbarGeprüft 2026-11-13 03:52:57 UTCHTTP 2005 msSchema stimmt übereinNeuester Datenpunkt 10.5h alt
Verfügbarkeit, letzte 30 Tage
100 % von 405 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/sd/cme/cotVerfügbarParameter
string — Coin symbol: `BTC`, `ETH`, `SOL` or `XRP`.
string · Standard 1y — Look-back range; one point per weekly report.
string · Standard 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.
Anfrage-URL
https://www.coinboss.com/api/sd/cme/cot?coin=BTCWählen Sie einen Endpunkt und klicken Sie auf „Anfrage senden“. Antwort, Header und Laufzeit erscheinen hier.
Mehr in dieser Kategorie
- CFTC-Positionierung (CME-Krypto-Futures) /api/sd/cme/cot
- Übersicht der CME-Futures /api/sd/cme/overview
- CFTC Commitments of Traders /api/cftc/cot