COT Data API — acces programatic la rapoartele CFTC săptămânale
Un API REST pentru datasetul Commitments of Traders. Auth bearer, răspunsuri JSON, patru endpoint-uri, 9,99 $/lună. Pentru traderi care programează, analiști care trag date în dashboard-uri și oricine are nevoie de COT report în altceva decât un browser sau spreadsheet.
ajoritatea cititorilor COT-Reports.com nu vor avea niciodată nevoie de un API. Site-ul acoperă cazul zilnic; spreadsheet-ul acoperă cazul săptămânal. Dar o dată pe trimestru cineva ne scrie cerând același lucru: "Aveți un API? Vreau să trag datele COT în [Python / un indicator TradingView / un dashboard intern / un bot Discord / o bază Notion]." Da. Se cheamă COT Data API și asta face.
Pitch-ul într-o propoziție: un endpoint REST care returnează același dataset Commitments of Traders care alimentează site-ul și template-ul Excel — autentificat bearer, formă JSON, coloane normalizate, istoric săptămânal. 9,99 $ pe lună, anulabil oricând.
Cine folosește de fapt un API pentru date COT?
Trei persoane, din experiența noastră:
**Traderul sistematic.** Rulează un model de poziționare în Python sau R. Citește noua publicare CFTC vineri după-amiază, recalculează semnalele, trimite ordine la broker luni dimineață.
**Analistul care construiește un dashboard.** Dashboard intern de echipă, panou Grafana, bază Notion, raport Tableau personalizat.
**Constructorul de unelte indie.** Bot Discord care postează noua publicare COT în fiecare vineri. Pine Script TradingView. Aplicație iOS.
Dacă workflow-ul tău arată ca unul dintre acestea, API-ul există pentru tine.
Cele patru endpoint-uri
Suprafața API e intenționat compactă. Patru endpoint-uri, fiecare face un lucru bine, toate returnează JSON:
**`GET /api/v1/markets`** — listează fiecare piață CFTC din catalogul nostru normalizat.
**`GET /api/v1/cot/{cftc_code}`** — istoric săptămânal pentru o piață. Default ultimele 520 săptămâni (~10 ani).
**`GET /api/v1/cot/{cftc_code}/latest`** — cel mai recent raport pentru o piață.
**`GET /api/v1/cot/{cftc_code}/index`** — COT Index stil Briese (percentilă 0-100 a poziționării nete non-commercial).
Plus un al cincilea, `GET /api/v1/demo`, care returnează un sample sintetic fix fără auth (10 cereri pe zi per IP).
Autentificare, limite de rate și detaliile practice
Auth e bearer token: `Authorization: Bearer cot_live_<32 hex>`. Generezi un token la /account/api după abonament — tokenurile sunt hashate SHA-256 în baza de date, niciodată stocate în clar.
Limitele tierului de intrare sunt 60 cereri pe minut și 500 cereri pe zi, per token. Expunem cota rămasă în headere `X-RateLimit-Remaining` pe fiecare răspuns.
Erorile vin ca envelope stabil: `{ "error": "<cod_mașină>", "message": "<text_uman>" }` cu status HTTP semnificativ.
Un exemplu minimal, în trei limbaje
Tragerea ultimei săptămâni pentru EUR FX (cod CFTC 099741) ia aproximativ atât cod cât te-ai aștepta:
**Python:**
```python import requests r = requests.get( "https://cot-reports.com/api/v1/cot/099741/latest", headers={"Authorization": "Bearer cot_live_..."}, ) data = r.json() print(data["row"]["noncomm_long"]) ```
**JavaScript / Node:**
```javascript const res = await fetch( "https://cot-reports.com/api/v1/cot/099741/latest", { headers: { Authorization: "Bearer cot_live_..." } } ) const data = await res.json() console.log(data.row.noncomm_long) ```
**Bash / curl:**
```bash curl https://cot-reports.com/api/v1/cot/099741/latest \ -H "Authorization: Bearer cot_live_..." ```
Spec-ul OpenAPI 3.0 trăiește la `/api/v1/openapi.json`.
Cum diferă de scrapingul arhivei CFTC tu însuți
Ai putea absolut să scrapezi arhiva CFTC SODA direct — e publică, gratuită și bine documentată. Atunci de ce să plătești 9,99 $/lună?
**Nume de coloane.** API-ul nostru returnează nume curate, predictibile: `noncomm_long`, `noncomm_short`, `comm_long`, `comm_short`.
**Consistență între familii.** API-ul normalizează toate cele patru familii la aceeași formă.
**COT Index integrat.** Percentila 0-100 Briese e un endpoint de o linie.
**Livrare rate-limited.** Când lovești endpoint-ul nostru, citești din cache-ul nostru, nu din serverele CFTC.
**Întreținere.** Când CFTC schimbă un nume de coloană, ruptura se întâmplă pe partea noastră.
Cum se potrivește alături de spreadsheet și Data Dump
Vindem trei produse de date și acoperă trei workflow-uri diferite:
**COT Report Spreadsheet (39 $ o singură plată)** — pentru traderul care trăiește în Excel.
**COT Data API (9,99 $/lună)** — pentru traderul care programează.
**COT Data Dump (49 $ o singură plată)** — pentru cazul când ai nevoie de toată arhiva istorică odată.
Sunt intenționat produse diferite cu prețuri diferite pentru că servesc cazuri de utilizare diferite.
Abonează-te la API la /api pe site-ul principal, generează primul token la /account/api, iar endpoint-ul demo va valida setup-ul tău înainte să scrii o singură linie de cod de producție.
