Skip to main content

COT cBot API

Τα δεδομένα Commitment of Traders εκθέτονται σε cBots και εξωτερικούς clients μέσω ενός πιστοποιημένου REST API, ώστε μια στρατηγική να μπορεί να τραβήξει θέση (καθαρή θέση, % ανοιχτού ενδιαφέροντος, δείκτης COT) ως είσοδος σήματος. Χρησιμοποιεί ξανά τον ίδιο μηχανισμό JWT και εύρος market:read με το API αγοράς ισχύος νομίσματος — ένα token, ένα σχήμα.

Πιστοποίηση​

  1. Στην εφαρμογή, εκδώστε έναν client δεδομένων αγοράς (owner) και χορηγήστε του το εύρος market:read.

  2. Ανταλλάξτε το ID/μυστικό client για ένα βραχύβιο bearer token:

    POST /api/calendar/v1/token
    Content-Type: application/json

    { "clientId": "…", "clientSecret": "…" }

    Η απάντηση φέρει token, expiresAt και τα χορηγούμενα scopes.

  3. Αποστείλετε το token σε κάθε κλήση COT:

    Authorization: Bearer <token>

Ένα token που λείπει/είναι μη έγκυρο επιστρέφει 401· ένα token χωρίς market:read επιστρέφει 403.

Τελικά σημεία​

Βασική διαδρομή /api/market/v1/cot. Όλες οι απαντήσεις είναι JSON.

Μέθοδος και διαδρομήΣκοπός
GET /marketsΟ κατάλογος αγορών σύμβασης που παρακολουθείται. Προαιρετικό group (Fx, Metals, Energy, Agriculture, Softs, Rates, Indices, Crypto) και λέξη-κλειδί q.
GET /latest?code={code}&kind={kind}&combined={bool}Το τελευταίο εβδομαδιαίο στιγμιότυπο για μια αγορά.
GET /history/{code}?kind={kind}&combined={bool}&from={iso}&to={iso}Εβδομαδιαίο ιστορικό σε ένα παράθυρο.

Παράμετροι:

  • code — ο κωδικός αγοράς σύμβασης CFTC (π.χ. 099741 για Euro FX· λάβε από /markets).
  • kind — Legacy (προεπιλογή), Disaggregated ή Tff.
  • combined — true για futures + options, false (προεπιλογή) για futures μόνο.
  • asOf (ISO-8601, προαιρετικό) — σημείο χρόνου: επιστρέφονται μόνο αναφορές που είναι δημόσιες σε εκείνη τη στιγμή, ώστε ένα backtest να μην βλέπει look-ahead.

Παράδειγμα​

GET /api/market/v1/cot/latest?code=088691&kind=Legacy HTTP/1.1
Authorization: Bearer <token>
{
  "contractCode": "088691",
  "marketName": "Gold",
  "kind": "Legacy",
  "combined": false,
  "reportDate": "2024-01-02T00:00:00+00:00",
  "knownAt": "2024-01-05T20:30:00+00:00",
  "openInterest": 450000,
  "cotIndex": 82.4,
  "extreme": "LongExtreme",
  "categories": [
    { "category": "NonCommercial", "long": 250000, "short": 90000, "net": 160000, "longPercentOfOi": 55.5 }
  ]
}

Εργαλεία MCP​

Το ίδιο μοντέλο ανάγνωσης διατίθεται σε AI clients ως εργαλεία MCP: CotMarkets, CotLatest, CotHistory και CotHealth — καθένα σωστό σημείο στο χρόνο μέσω ενός προαιρετικού asOf. Δείτε χαρακτηριστικό Commitment of Traders για την πλήρη εικόνα.

Gating​

Το API βρίσκεται πίσω από το ίδιο δύο-επίπεδο gating με τη σελίδα: App:Branding:EnableCot και App:Features:Cot. Με καθένα ανενεργό κάθε διαδρομή κάτω από /api/market/v1/cot επιστρέφει 404.