GET /api/v1/markets
Listează fiecare piață CFTC cu categorie, bursă și apartenența la familiile de rapoarte. Filtrează după categorie, familie, doar tracked sau căutare substring.
CONTRA COST · API REST · AUTH BEARER
Trage fiecare piață CFTC — programatic.
Bearer auth · JSON · 60 cereri/min · 500 cereri/zi
+380 piețe pe toate cele patru familii de rapoarte CFTC, coloane normalizate, istoric săptămânal, endpoint-uri REST. $9.99/lună — anulezi oricând.
COT Data API e un API REST de $9.99/lună care expune același set de date CFTC Commitments of Traders care alimentează cot-reports.com. Autentificare bearer, răspunsuri JSON, patru endpoint-uri (lista de piețe, istoric, săptămâna curentă, COT Index) plus un demo static gratuit pentru validarea formatului. Datele CFTC subiacente sunt din domeniul public federal SUA (17 USC §105); valoarea acestui produs e curatoria coloanelor, livrarea cu rate limiting și specificația OpenAPI 3.0.
$9.99 / lunăAnulezi oricând. Acces până la finalul perioadei plătite.
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)"
}
}Patru endpoint-uri, plus un demo gratuit
GET /api/v1/cot/{cftc_code}
Istoric săptămânal pentru o singură piață. Returnează implicit ultimele 520 de săptămâni; from / to / family / limit sunt parametri opționali în query.
GET /api/v1/cot/{cftc_code}/latest
Cel mai recent raport pentru o piață. Pre-calculat pentru pattern-ul tipic de polling vinerea după publicare.
GET /api/v1/cot/{cftc_code}/index
COT Index în stil Briese (percentilă 0–100) pentru cel mai recent raport raportat la fereastra de lookback. Implicit 52 de săptămâni.
Plus un endpoint gratuit fără auth GET /api/v1/demo care returnează un răspuns sintetic static — folosește-l să-ți validezi parser-ul înainte de abonament. 10 cereri/zi per IP.
Limite de rată
- 60 de cereri pe minut
- 500 de cereri pe zi
- Headere standard X-RateLimit-* pe fiecare răspuns
- La 429, header-ul Retry-After îți spune câte secunde să aștepți
Construit sigur
Token-urile sunt string-uri bearer de 36 de caractere (cot_live_<32 hex>). Hash-uim cu SHA-256 și stocăm doar hash-ul; tokenul brut îți e afișat exact o dată la creare. Comparație în timp constant la validare. Logging per-token + per-IP-hash pentru detectare abuz. Anularea respectă perioada plătită — tokenul rămâne activ până la finalul perioadei de facturare curente, apoi e revocat automat. Revocarea manuală imediată se face dintr-un clic pe /account/api.
Livrează o integrare COT după-amiaza asta.
Fără paginare SODA. Fără typo-uri la nume de coloane CFTC. Fără cron săptămânal de babysitter. Cinci endpoint-uri, un singur token bearer, gata de consumat.
Anulezi oricând. Autentificare Bearer. Răspunsuri JSON. Endpoint demo gratuit pentru validare.
Citește documentația APIÎntrebări frecvente
Ce e acoperit de nivelul entry?
Fiecare endpoint, fiecare piață, fiecare familie de rapoarte. Singura diferență dintre nivelurile Entry, Pro și Business e limita de cereri pe minut și pe zi — Pro și Business apar mai târziu.
Pot partaja tokenul între mașini?
Un token per abonament. Partajarea între sisteme e o încălcare a Termenilor; logăm per-token ȘI per-IP-hash și revocăm token-uri al căror pattern de utilizare indică distribuție. Folosește cheia API în CI / serverul de producție, ține-o departe de clienți.
Cum funcționează anularea?
Anulează oricând din Stripe Customer Portal. Anularea standard îți păstrează accesul API activ până la finalul perioadei facturate curente — ai plătit până la acea dată, deci poți să-l folosești în continuare. La finalul perioadei tokenul este revocat automat. Dacă ai nevoie să revoci imediat (de exemplu token compromis, rotație de cheie CI), folosește butonul Revoke de pe /account/api — efectul se simte din chiar următoarea cerere.
Ce e endpoint-ul demo?
/api/v1/demo returnează un răspuns JSON sintetic fix cu un flag sample:true și mesajul "This is a sample response." Fără date CFTC reale, fără auth, 10 cereri/zi per IP. Folosește-l să-ți validezi parser-ul; nu încerca să-l folosești ca sursă gratuită — fiecare răspuns e identic.
Ce se întâmplă dacă schema se schimbă?
Adăugăm coloane fără să stricăm nimic — parser-ul tău continuă să funcționeze. Redenumirile, ștergerile sau reordonările trec la o versiune majoră de schemă și sunt anunțate cu 30 de zile înainte în changelog la https://cot-reports.com/api plus o notificare în dashboard-ul /account/api pentru abonații activi. Fixează codul tău pe câmpurile pe care chiar le folosești, adaugă un unit test care eșuează pe null neașteptat, și ai încredere în contract.
Cum mă autentific?
Fiecare request are nevoie de un header `Authorization: Bearer <token>`. Token-urile au forma `cot_live_<32 caractere hex>` (sau `cot_test_…` pe preview/dev), 36 de caractere în total cu prefixul. Obține-l din /account/api după ce te abonezi — e afișat o singură dată, deci salvează-l imediat. Exemplu: `curl -H 'Authorization: Bearer cot_live_abc123…' https://cot-reports.com/api/v1/markets`. Fără OAuth, fără request-uri semnate, fără client IDs — doar bearer token.
Ce limbaje de programare și biblioteci pot folosi?
Orice face request-uri HTTPS. API-ul e REST + JSON simplu, deci Python (`requests`, `httpx`), Node.js (`fetch`, `axios`), Go (`net/http`), Rust (`reqwest`), R (`httr`), curl și Postman merg out of the box. Specificația OpenAPI 3.0 de la /api/v1/openapi.json îți permite să generezi clienți tipizați cu `openapi-generator-cli` pentru oricare dintre cele de mai sus plus C#, Java, Swift, Kotlin, PHP, Ruby. Nu necesită SDK — păstrarea API-ului plain REST e o decizie deliberată.
Cât de fresh sunt datele — și cum se ține API-ul actualizat?
Aceeași freshness ca publicarea CFTC. Watcher-ul nostru automat verifică CFTC SODA din oră în oră, într-o fereastră de 4 ore în jurul release-ului de vineri 15:30 ET, acoperind atât Eastern Daylight cât și Standard Time plus release-uri întârziate în săptămânile cu sărbători US. Imediat ce sosesc date noi, `/api/v1/cot/<code>/latest` și `/api/v1/cot/<code>/index` returnează săptămâna nouă în câteva minute. Endpoint-ul istoric `/api/v1/cot/<code>` returnează mereu seria completă până la ultima săptămână publicată.
Există un free tier sau un trial?
Nu pentru date reale. Folosirea gratuită e limitată la `/api/v1/demo` — un endpoint fără autentificare care returnează un răspuns JSON sintetic fix cu `sample: true` pentru validarea parser-ului. 10 request-uri/zi per IP. Datele CFTC reale necesită abonament. Nu rulăm un freemium pentru că publicarea CFTC nu ne costă nimic; ce plătești e normalizarea, livrarea rate-limited, specificația OpenAPI, lifecycle-ul bearer-token, și uptime-ul 24/7 în jurul ferestrei de release de vineri.