GET /api/v1/markets
Listet jeden CFTC-Markt mit Kategorie, Börse und Report-Familien-Zugehörigkeit. Filter nach Kategorie, Familie, nur tracked-Märkten oder Substring-Suche.
BEZAHLT · REST-API · BEARER AUTH
Jeder CFTC-Markt — programmatisch abrufbar.
Bearer-Auth · JSON · 60 Req/Min · 500 Req/Tag
+380 Märkte über alle vier CFTC-Report-Familien, normalisierte Spalten, wöchentliche Historie, REST-Endpunkte. $9.99/Monat — jederzeit kündbar.
COT Data API ist eine REST API für $9.99/Monat, die denselben CFTC Commitments of Traders Datensatz bereitstellt, der cot-reports.com antreibt. Bearer-Authentifizierung, JSON-Antworten, vier Endpunkte (Markt-Liste, Historie, aktuelle Woche, COT Index) plus ein kostenloser statischer Demo-Endpunkt zur Format-Validierung. Die zugrundeliegenden CFTC-Daten sind US-Bundes-Public-Domain (17 USC §105); der Mehrwert dieses Produkts liegt in der Kuratierung normalisierter Spalten, der ratenlimitierten Auslieferung und der OpenAPI 3.0 Spec.
$9.99 / MonatJederzeit kündbar. Zugriff bis zum Ende der bezahlten Periode.
GET /cot/{code}/latest
$ curl -H "Authorization: Bearer cot_live_..." \
https://cot-reports.com/api/v1/cot/DEMO_FUTURES/latest
{
"cftc_code": "DEMO_FUTURES",
"family": "legacy",
"row": {
"report_date": "2026-04-22",
"cftc_code": "DEMO_FUTURES",
"market_name": "DEMO FUTURES (Sample / not a real market)",
"open_interest": 412876,
"change_open_interest": 8234,
"noncomm_long": 156000,
"noncomm_short": 234000,
"noncomm_spreading": 18500,
"change_noncomm_long": 4200,
"change_noncomm_short": -3100,
"change_noncomm_spreading": 540,
"comm_long": 198400,
"comm_short": 121900,
"change_comm_long": -2100,
"change_comm_short": 6800,
"nonrept_long": 39976,
"nonrept_short": 38476,
"change_nonrept_long": 320,
"change_nonrept_short": -185,
"pct_oi_noncomm_long": 37.78,
"pct_oi_noncomm_short": 56.67,
"pct_oi_noncomm_spreading": 4.48,
"pct_oi_comm_long": 48.06,
"pct_oi_comm_short": 29.53,
"pct_oi_nonrept_long": 9.68,
"pct_oi_nonrept_short": 9.32,
"contract_units": "DEMO 100,000 (synthetic)"
}
}Vier Endpunkte, plus ein kostenloser Demo
GET /api/v1/cot/{cftc_code}
Wöchentliche Historie für einen Markt. Standard: letzte 520 Wochen; from / to / family / limit sind optionale Query-Parameter.
GET /api/v1/cot/{cftc_code}/latest
Aktuellster Bericht für einen Markt. Vorberechnet für das typische Freitag-nach-Veröffentlichung Polling-Pattern.
GET /api/v1/cot/{cftc_code}/index
COT Index im Briese-Stil (0–100 Perzentil) für den aktuellsten Bericht relativ zum Lookback-Fenster. Standard 52 Wochen.
Plus ein kostenloser, auth-loser Endpunkt GET /api/v1/demo, der eine statische synthetische Antwort liefert — nutze ihn zur Parser-Validierung vor dem Abonnement. 10 Req/Tag pro IP.
Rate Limits
- 60 Anfragen pro Minute
- 500 Anfragen pro Tag
- Standard X-RateLimit-* Header auf jeder Antwort
- Bei 429 zeigt der Retry-After Header an, wie viele Sekunden zu warten sind
Sicher gebaut
Tokens sind 36-Zeichen Bearer-Strings (cot_live_<32 hex>). Wir hashen mit SHA-256 und speichern nur den Hash; der rohe Token wird dir genau einmal bei der Erstellung angezeigt. Konstantzeit-Vergleich bei der Validierung. Logging pro Token UND pro IP-Hash zur Missbrauchserkennung. Kündigung respektiert die bezahlte Periode — der Token bleibt aktiv bis zum Ende der laufenden Abrechnungsperiode, dann automatischer Widerruf. Sofortiger manueller Widerruf jederzeit per Klick auf /account/api.
Liefere eine COT-Integration noch heute Nachmittag.
Keine SODA-Pagination. Keine CFTC-Spaltennamen-Typos. Kein wöchentlicher Cron-Babysitter. Fünf Endpunkte, ein Bearer-Token, einsatzbereit.
Jederzeit kündbar. Bearer-Auth. JSON-Antworten. Kostenloser Demo-Endpoint zur Validierung.
API-Referenz lesenHäufige Fragen
Was ist im Entry-Tier enthalten?
Jeder Endpunkt, jeder Markt, jede Report-Familie. Der einzige Unterschied zwischen Entry, Pro und Business sind die Pro-Minute- und Pro-Tag-Limits — Pro und Business folgen später.
Kann ich den Token zwischen Maschinen teilen?
Ein Token pro Abonnement. Geteilte Nutzung über Systeme hinweg ist ein AGB-Verstoß; wir loggen pro Token UND pro IP-Hash und widerrufen Tokens, deren Nutzungsmuster eine Verteilung anzeigt. Verwende den API-Key in CI / Production-Server, halte ihn aus Clients heraus.
Wie funktioniert die Kündigung?
Jederzeit im Stripe Customer Portal kündbar. Standard-Kündigung lässt deinen API-Zugang bis zum Ende der laufenden Abrechnungsperiode aktiv — du hast für diesen Zeitraum bezahlt, du nutzt ihn. Am Periodenende wird der Token automatisch widerrufen. Wenn du sofortigen Widerruf brauchst (geleakter Token, CI-Rotation), nutze den Revoke-Button auf /account/api — wirkt ab der nächsten Anfrage.
Was ist der Demo-Endpunkt?
/api/v1/demo liefert eine feste synthetische JSON-Antwort mit einem sample:true Flag und der Nachricht "This is a sample response." Keine echten CFTC-Daten, keine Auth, 10 Req/Tag pro IP. Nutze ihn zur Parser-Validierung; versuche nicht, ihn als kostenlose Datenquelle zu verwenden — jede Antwort ist identisch.
Was passiert wenn sich das Schema ändert?
Wir fügen Spalten hinzu, ohne etwas zu brechen — Ihr Parser funktioniert weiter. Umbenennungen, Entfernungen oder Umsortierungen erzeugen eine neue Hauptschemaversion und werden 30 Tage im Voraus im Changelog unter https://cot-reports.com/api plus einer Mitteilung im /account/api-Dashboard für aktive Abonnenten angekündigt. Pinnen Sie Ihren Code an die Felder, die Sie tatsächlich nutzen, fügen Sie einen Unit-Test hinzu, der bei unerwarteten Nulls fehlschlägt, und vertrauen Sie dem Vertrag.
Wie authentifiziere ich mich?
Jede Anfrage benötigt einen `Authorization: Bearer <token>`-Header. Tokens haben das Format `cot_live_<32 Hex-Zeichen>` (oder `cot_test_…` in Preview/Dev), 36 Zeichen insgesamt einschließlich Präfix. Holen Sie sich Ihren unter /account/api nach dem Abonnement — er wird genau einmal angezeigt, also sofort sichern. Beispiel: `curl -H 'Authorization: Bearer cot_live_abc123…' https://cot-reports.com/api/v1/markets`. Kein OAuth, keine signierten Anfragen, keine Client IDs — nur das Bearer Token.
Welche Programmiersprachen und Bibliotheken kann ich verwenden?
Alles, was HTTPS-Anfragen macht. Die API ist plain REST + JSON, also funktionieren Python (`requests`, `httpx`), Node.js (`fetch`, `axios`), Go (`net/http`), Rust (`reqwest`), R (`httr`), curl und Postman sofort. Die OpenAPI-3.0-Spezifikation unter /api/v1/openapi.json erlaubt das Generieren typisierter Clients mit `openapi-generator-cli` für alle oben genannten Sprachen plus C#, Java, Swift, Kotlin, PHP, Ruby. Kein SDK erforderlich — die API plain REST zu halten ist eine bewusste Entscheidung.
Wie aktuell sind die Daten — und wie bleibt die API auf dem neuesten Stand?
Gleiche Aktualität wie die CFTC-Veröffentlichung selbst. Unser Auto-Watcher fragt CFTC SODA stündlich in einem 4-Stunden-Fenster um die Freitag-15:30-ET-Veröffentlichung ab, abdeckend sowohl Eastern Daylight als auch Standard Time plus verzögerte Veröffentlichungen in US-Feiertagswochen. Sobald neue Daten landen, geben `/api/v1/cot/<code>/latest` und `/api/v1/cot/<code>/index` die neue Woche innerhalb von Minuten zurück. Der historische Endpoint `/api/v1/cot/<code>` gibt immer die vollständige Serie bis zur zuletzt veröffentlichten Woche zurück.
Gibt es eine kostenlose Stufe oder eine Testphase?
Nicht für echte Daten. Kostenlose Nutzung ist auf `/api/v1/demo` beschränkt — ein Endpoint ohne Authentifizierung, der eine feste synthetische JSON-Antwort mit `sample: true` zur Parser-Validierung zurückgibt. 10 Anfragen/Tag pro IP. Echte CFTC-Daten erfordern das kostenpflichtige Abonnement. Wir betreiben kein Freemium, weil die CFTC-Veröffentlichung uns nichts kostet; wozu Sie bezahlen, ist die Normalisierung, die rate-limitierte Lieferung, die OpenAPI-Spec, der Bearer-Token-Lebenszyklus und die 24/7-Verfügbarkeit rund um das Freitag-Release-Fenster.