Lo que devuelve
Posicionamiento semanal de traders grandes en cada mercado de futuros de EE.UU., directamente desde los datos oficiales de Compromisos de Traders de la CFTC (publicreporting.cftc.gov). Cubre oro, crudo, gas natural, granos, divisas, bonos del Tesoro, futuros de índices accionarios, Bitcoin y cientos más, con historia desde 1986.
Una fila por mercado por informe semanal: fecha del informe, mercado, código de contrato, intercambio, grupo de materias primas, interés abierto, posiciones largas/cortas/extendidas para cada grupo de traders, cambios semana a semana, porcentaje del interés abierto, conteo de traders y ratios de concentración. Las posiciones netas se calculan previamente (p. ej. managedMoneyNet, leveragedFundsNet, nonCommercialNet).
Solicitud
POST https://api.pushbuild.com/cftc-commitments-of-traders/run con un cuerpo JSON. Envía tu clave en el encabezado X-API-Key.
| Campo | Tipo | Descripción |
|---|---|---|
report | string: legado, desagregado, financiero | Which COT report format. Default: "legacy". |
includeOptions | boolean | Apagado: solo futuros. Encendido: futuros y opciones combinados. Por defecto: false. |
markets | lista de cadenas | Coincidencia de texto en el nombre del mercado, por ejemplo, GOLD, CRUDE OIL, E-MINI S&P 500, EURO FX, BITCOIN. |
contractCodes | lista de cadenas | Códigos exactos de mercado de contratos de la CFTC, por ejemplo, 088691 (oro), 13874A (E-mini S&P 500). |
commodityGroup | string | por ejemplo, NATURAL RESOURCES, AGRICULTURE, FINANCIAL INSTRUMENTS. |
exchangeCode | string | por ejemplo, CME, CBT, NYME, CMX, ICUS. |
latestOnly | boolean | Solo el informe semanal más reciente. Por defecto: encendido cuando no se proporcionan fechas. |
dateFrom | string | Fecha del informe YYYY-MM-DD (fecha de corte del martes). |
dateTo | string | YYYY-MM-DD. |
sort | string: newest, oldest | Orden de fecha del informe. Por defecto: "newest". |
maxItems | entero | Número máximo de elementos a devolver (1-500). Predeterminado: 100. |
Ejemplo
curl -X POST https://api.pushbuild.com/cftc-commitments-of-traders/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"markets": ["GOLD"], "maxItems": 20}'Respuesta
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Cada llamada devuelve hasta 500 elementos. Los registros que no pasan la validación o no se encuentran se marcan en los elementos y no se cobran.
Precios
Pague solo por los resultados devueltos: $0,16 por 1.000 filas. Sin cargo por errores o búsquedas vacías.
Úselo desde Claude, ChatGPT o Cursor
Esta API también es un servidor MCP: https://api.pushbuild.com/mcp/cftc-commitments-of-traders. Agréguelo a cualquier asistente que soporte servidores MCP remotos, con su clave en el encabezado X-API-Key. Mismos precios. Configuración para cada aplicación.
Díganos qué necesitan construir.
Preguntas sobre esta API, volúmenes más altos, o una fuente de datos que necesiten que aún no cubrimos.
hello@pushbuild.com