COT Data API

Autenticazione

Ogni richiesta tranne /api/v1/demo richiede un token bearer. Abbonati su cot-reports.com/api, genera un token da /account/api, e includilo nell'header Authorization.

curl -H "Authorization: Bearer cot_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  https://cot-reports.com/api/v1/markets

I token sono di 36 caratteri totali (prefisso cot_live_ + 32 caratteri hex). Il token completo viene mostrato esattamente una volta alla creazione; conserviamo solo un hash SHA-256. I token persi non sono recuperabili — revoca il vecchio e generane uno nuovo.

Rate limit

Ogni risposta contiene X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset per la più stretta delle due finestre, più chiavi per finestra (-Minute / -Day) per telemetria più ricca. Su 429, Retry-After indica i secondi di attesa.

Codici di errore

Esempio JavaScript

const r = await fetch('https://cot-reports.com/api/v1/cot/099741/index?lookback=52', {
  headers: { Authorization: `Bearer ${process.env.COT_API_TOKEN}` },
})
if (!r.ok) {
  const { error, message } = await r.json()
  throw new Error(`COT API ${r.status} ${error}: ${message}`)
}
const { cot_index, latest_report_date } = await r.json()
console.log(`COT Index for EURO FX as of ${latest_report_date}: ${cot_index}`)

Spec OpenAPI 3.0

Descrizione machine-readable di ogni endpoint sopra. Importabile in Postman, Insomnia, OpenAPI Generator, ecc.

Uso consentito

• Un token per abbonato. La condivisione di token tra utenti o sistemi oltre quanto coperto dall'abbonamento è una violazione dei Termini; revochiamo i token che mostrano pattern di IP distribuiti.
• I dati CFTC stessi sono di pubblico dominio (17 USC §105). Puoi costruire prodotti a pagamento sopra, ridistribuire risultati di query, o alimentare qualsiasi modello. Non restringiamo la semantica dei dati.
• Lo scraping massivo per ricreare gratuitamente il Data Dump è vietato — compra il Data Dump se è ciò di cui hai bisogno; costa 49 $ una tantum e ti risparmia il balletto dei rate-limit.
• L'aggiramento dei rate limit (IP rotanti, token paralleli verso lo stesso endpoint) viola i Termini. Loggiamo per token + per hash IP esattamente per questo motivo.

Termini completi: /terms.