La COT Data API — acceso programático a los informes CFTC semanales
Una API REST para el dataset Commitments of Traders. Auth bearer, respuestas JSON, cuatro endpoints, 9,99 $/mes. Para traders que programan, analistas que pipan datos en dashboards, y cualquiera que necesite el COT report dentro de algo distinto a un navegador o una hoja de cálculo.
a mayoría de lectores de COT-Reports.com nunca necesitarán una API. El sitio cubre el caso diario; la hoja de cálculo cubre el caso semanal. Pero una vez por trimestre alguien nos escribe pidiendo lo mismo: "¿Tienen una API? Quiero pipar los datos COT en [Python / un indicador TradingView / un dashboard interno / un bot Discord / una base Notion]." Sí. Se llama COT Data API y esto es lo que hace.
El pitch en una frase: un endpoint REST que devuelve el mismo dataset Commitments of Traders que alimenta el sitio y la plantilla Excel — autenticado bearer, JSON, columnas normalizadas, historial semanal. 9,99 $ al mes, cancelable en cualquier momento.
¿Quién usa realmente una API para datos COT?
Tres personas, según nuestra experiencia:
**El trader sistemático.** Ejecuta un modelo de posicionamiento en Python o R. Lee la nueva salida CFTC el viernes por la tarde, recalcula señales, envía órdenes al broker el lunes por la mañana.
**El analista que construye un dashboard.** Dashboard de equipo interno, panel Grafana, base Notion, informe Tableau personalizado.
**El constructor de herramientas indie.** Bot Discord que postea la nueva salida COT cada viernes. Pine Script TradingView. App iOS.
Si tu workflow se parece a uno de estos, la API existe para ti.
Los cuatro endpoints
La superficie API es intencionalmente compacta. Cuatro endpoints, cada uno hace una cosa bien, todos devuelven JSON:
**`GET /api/v1/markets`** — lista cada mercado CFTC en nuestro catálogo normalizado.
**`GET /api/v1/cot/{cftc_code}`** — historial semanal para un mercado. Por defecto las últimas 520 semanas (~10 años).
**`GET /api/v1/cot/{cftc_code}/latest`** — informe más reciente para un mercado.
**`GET /api/v1/cot/{cftc_code}/index`** — COT Index estilo Briese (percentil 0-100 del posicionamiento neto non-commercial).
Más un quinto, `GET /api/v1/demo`, que devuelve una muestra sintética fija sin auth (10 peticiones al día por IP).
Autenticación, rate limits y los detalles prácticos
Auth es bearer token: `Authorization: Bearer cot_live_<32 hex>`. Generas un token en /account/api tras la suscripción — los tokens son hasheados SHA-256 en la base de datos, nunca almacenados en texto plano.
Los límites del tier de entrada son 60 peticiones por minuto y 500 peticiones al día, por token. Exponemos la cuota restante en headers `X-RateLimit-Remaining` en cada respuesta.
Los errores vuelven como envelope estable: `{ "error": "<código_máquina>", "message": "<texto_humano>" }` con estado HTTP significativo.
Un ejemplo mínimo, en tres lenguajes
Tirar la última semana para EUR FX (código CFTC 099741) requiere aproximadamente el código que esperas:
**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_..." ```
La spec OpenAPI 3.0 vive en `/api/v1/openapi.json`.
En qué se diferencia de scrapear el archivo CFTC tú mismo
Podrías absolutamente scrapear el archivo CFTC SODA directamente — es público, gratuito y bien documentado. ¿Entonces por qué pagar 9,99 $/mes?
**Nombres de columnas.** Nuestra API devuelve nombres limpios y predecibles: `noncomm_long`, `noncomm_short`, `comm_long`, `comm_short`.
**Consistencia entre familias.** La API normaliza las cuatro familias a la misma forma.
**COT Index integrado.** El percentil 0-100 Briese es un endpoint de una línea.
**Entrega rate-limited.** Cuando golpeas nuestro endpoint, lees desde nuestra cache, no desde los servidores CFTC.
**Mantenimiento.** Cuando la CFTC cambia un nombre de columna, la ruptura ocurre en nuestro lado.
Cómo encaja junto a la hoja de cálculo y al Data Dump
Vendemos tres productos de datos y cubren tres workflows distintos:
**El COT Report Spreadsheet (39 $ pago único)** — para el trader que vive en Excel.
**La COT Data API (9,99 $/mes)** — para el trader que programa.
**El COT Data Dump (49 $ pago único)** — para el caso donde necesitas todo el archivo histórico de una vez.
Son intencionalmente productos distintos con precios distintos porque sirven casos de uso distintos.
Suscríbete a la API en /api en el sitio principal, genera tu primer token en /account/api, y el endpoint demo validará tu setup antes de que escribas una sola línea de código de producción.
