COT Data API

Autenticación

Cada petición excepto /api/v1/demo requiere un token bearer. Suscríbete en cot-reports.com/api, genera un token desde /account/api, e inclúyelo en la cabecera Authorization.

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

Los tokens tienen 36 caracteres en total (prefijo cot_live_ + 32 caracteres hex). El token completo se muestra exactamente una vez en la creación; solo almacenamos un hash SHA-256. Los tokens perdidos no se pueden recuperar — revoca el viejo y genera uno nuevo.

Límites de tasa

Cada respuesta lleva X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset para la más estricta de las dos ventanas, más claves por ventana (-Minute / -Day) para telemetría más rica. En 429, Retry-After indica segundos de espera.

Códigos de error

Ejemplo 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

Descripción legible por máquina de cada endpoint arriba. Importable en Postman, Insomnia, OpenAPI Generator, etc.

Uso aceptable

• Un token por suscriptor. Compartir tokens entre usuarios o sistemas más allá de lo que cubre tu suscripción viola los Términos; revocamos tokens que muestran patrones de IP distribuidos.
• Los datos CFTC en sí son de dominio público (17 USC §105). Puedes construir productos de pago encima, redistribuir resultados de consultas, o alimentar cualquier modelo. No restringimos la semántica de los datos.
• El scraping masivo para recrear gratuitamente el Data Dump está prohibido — compra el Data Dump si es lo que necesitas; cuesta 49 US$ una sola vez y te ahorra el baile de rate-limits.
• Eludir los límites de tasa (IPs rotatorias, tokens paralelos al mismo endpoint) viola los Términos. Logueamos por token + por hash de IP exactamente por esta razón.

Términos completos: /terms.