Commitments of Traders de la CFTC

Commitments of Traders de la CFTC (futuros de bitcoin / ether de CME)

GET/api/cftc/cot

Serie anterior y más corta. `/api/sd/cme/cot` contiene el historial completo de la CFTC por clase de operador, con selección de unidad.

Solicitud

Parámetros de consulta

Nombre	Tipo	Obligatorio	Valor por defecto	Valores admitidos	Descripción
currency	string	Opcional	BTC	BTC, ETH	Subyacente; cualquier valor distinto de ETH se trata como BTC. Ejemplo: BTC

Solicitud de ejemplo

curl -s "https://www.coinboss.com/api/cftc/cot?currency=BTC"

Campos de la respuesta

La tabla de campos se genera a partir de respuestas reales, por lo que recoge exactamente lo que devuelve el endpoint. Las rutas usan a[] para los elementos de un array y {*} para los objetos cuya clave es un nombre dinámico, como una moneda o un exchange.

Campo	Tipo	Unidad	Descripción
success	boolean	—	true cuando la solicitud se completó correctamente. En caso de fallo, el cuerpo es `{ success: false, code, error, request_id }`.
currency	string	—	Símbolo de la divisa / del activo.
contract	string	—	Nombre y tamaño de contrato del contrato de futuros de CME que cubre el informe (`CME Bitcoin Futures (5 BTC)` o `CME Ether Futures (50 ETH)`).
report_date	string	—	Fecha de referencia (YYYY-MM-DD, un martes) del último informe Commitments of Traders de la CFTC en `series`; se publica el viernes siguiente.
fetched_at	number	ms	Cuándo obtuvo CoinBoss los datos de la fuente.
latest	object	—	Registro más reciente.
latest.date	string	—	Fecha de calendario (UTC).
latest.oi	number	—	Interés abierto.
latest.dealer_long	number	—	Informe de la CFTC: posiciones largas de dealers.
latest.dealer_short	number	—	Informe de la CFTC: posiciones cortas de dealers.
latest.am_long	number	—	Informe de la CFTC: posiciones largas de gestores de activos.
latest.am_short	number	—	Informe de la CFTC: posiciones cortas de gestores de activos.
latest.lev_long	number	—	Informe de la CFTC: posiciones largas de fondos apalancados.
latest.lev_short	number	—	Informe de la CFTC: posiciones cortas de fondos apalancados.
latest.other_long	number	—	Informe de la CFTC: posiciones largas de otros declarantes.
latest.other_short	number	—	Informe de la CFTC: posiciones cortas de otros declarantes.
latest.nonrept_long	number	—	Informe de la CFTC: posiciones largas de no declarantes.
latest.nonrept_short	number	—	Informe de la CFTC: posiciones cortas de no declarantes.
latest.traders	number	—	Número de operadores.
prev	object	—	Valor anterior (referencia).
prev.date	string	—	Fecha de calendario (UTC).
prev.oi	number	—	Interés abierto.
prev.dealer_long	number	—	Informe de la CFTC: posiciones largas de dealers.
prev.dealer_short	number	—	Informe de la CFTC: posiciones cortas de dealers.
prev.am_long	number	—	Informe de la CFTC: posiciones largas de gestores de activos.
prev.am_short	number	—	Informe de la CFTC: posiciones cortas de gestores de activos.
prev.lev_long	number	—	Informe de la CFTC: posiciones largas de fondos apalancados.
prev.lev_short	number	—	Informe de la CFTC: posiciones cortas de fondos apalancados.
prev.other_long	number	—	Informe de la CFTC: posiciones largas de otros declarantes.
prev.other_short	number	—	Informe de la CFTC: posiciones cortas de otros declarantes.
prev.nonrept_long	number	—	Informe de la CFTC: posiciones largas de no declarantes.
prev.nonrept_short	number	—	Informe de la CFTC: posiciones cortas de no declarantes.
prev.traders	number	—	Número de operadores.
series	array	—	Serie temporal.
series[]	object	—	Serie temporal.
series[].date	string	—	Fecha de calendario (UTC).
series[].oi	number	—	Interés abierto.
series[].dealer_long	number	—	Informe de la CFTC: posiciones largas de dealers.
series[].dealer_short	number	—	Informe de la CFTC: posiciones cortas de dealers.
series[].am_long	number	—	Informe de la CFTC: posiciones largas de gestores de activos.
series[].am_short	number	—	Informe de la CFTC: posiciones cortas de gestores de activos.
series[].lev_long	number	—	Informe de la CFTC: posiciones largas de fondos apalancados.
series[].lev_short	number	—	Informe de la CFTC: posiciones cortas de fondos apalancados.
series[].other_long	number	—	Informe de la CFTC: posiciones largas de otros declarantes.
series[].other_short	number	—	Informe de la CFTC: posiciones cortas de otros declarantes.
series[].nonrept_long	number	—	Informe de la CFTC: posiciones largas de no declarantes.
series[].nonrept_short	number	—	Informe de la CFTC: posiciones cortas de no declarantes.
series[].traders	number	—	Número de operadores.

Generada 2026-11-11 23:00 UTC a partir de 1 respuestas reales.

Respuesta de ejemplo

/api/cftc/cot?currency=BTC · Respuesta real capturada 2026-11-13 03:58:26 UTC. Los arrays y mapas largos se abrevian para su visualización: series tenía 448 elementos.

{
- "success": true,
- "currency": "BTC",
- "contract": "CME Bitcoin Futures (5 BTC)",
- "report_date": "2026-11-03",
- "fetched_at": 1794536904404,
- "latest": {
  - "date": "2026-11-03",
  - "oi": 17527,
  - "dealer_long": 6027,
  - "dealer_short": 5548,
  - "am_long": 4379,
  - "am_short": 1976,
  - "lev_long": 5114,
  - "lev_short": 7705,
  - "other_long": 124,
  - "other_short": 308,
  - "nonrept_long": 762,
  - "nonrept_short": 869,
  - "traders": 105
  },
- "prev": {
  - "date": "2026-10-27",
  - "oi": 20791,
  - "dealer_long": 6257,
  - "dealer_short": 5001,
  - "am_long": 4743,
  - "am_short": 1989,
  - "lev_long": 5887,
  - "lev_short": 9866,
  - "other_long": 94,
  - "other_short": 285,
  - "nonrept_long": 1002,
  - "nonrept_short": 842,
  - "traders": 106
  },
- "series": [
  - { … 13 },
  - { … 13 }
  ]
}

Detalles

Autenticación: Ninguna. Endpoint público.
Límite de solicitudes: 1200 solicitudes por minuto por IP
Caché del servidor: 10m
Microcaché de borde: 10s
Frecuencia de actualización: bajo demanda, en caché 6 horas; el informe es semanal (posiciones del martes, publicado el viernes)
Ventana: historial semanal completo
Fuentes de datos: Posicionamiento en los futuros de Bitcoin y Ether de CME por categoría de operador, a partir de los datos abiertos oficiales de Commitments of Traders de la CFTC.
Cobertura de exchanges: `currency` = BTC (por defecto) o ETH; solo contratos estándar de CME (no se incluyen los microcontratos); categorías: dealer, gestor de activos, fondos apalancados, otros declarantes, no declarantes.
Ordenación: fecha del informe ascendente
Unidades: contracts (CME Bitcoin = 5 BTC, CME Ether = 50 ETH per contract)
Marcas de tiempo: Milisegundos de época Unix (UTC), salvo que la descripción del campo indique otra cosa
Formato de respuesta: json
Estabilidad: Estable

Estado en vivo

DisponibleComprobado 2026-11-13 03:58:26 UTCHTTP 2007 msEl esquema coincideAntigüedad del dato más reciente: 10.2d

Disponibilidad, últimos 30 días

100% de 409 comprobaciones superadas

Errores

Las llamadas fallidas tienen la misma estructura en todos los endpoints. La lista completa está en la página de errores. Errores y límites de solicitudes →

Código	HTTP	Significado	Qué hacer
INVALID_PARAM	400	Falta un parámetro obligatorio o un valor no se acepta. `param` indica el nombre del parámetro cuando se conoce.	No reintente sin cambios; corrija la solicitud.
UNAUTHORIZED	401	Se envió la cabecera `CB-API-KEY`, pero la clave es desconocida o está revocada. Los datos públicos no necesitan clave: elimine la cabecera o use una clave válida.	No reintente sin cambios.
FORBIDDEN	403	La ruta no forma parte de la API pública (interna o solo para cuentas).	No reintente.
NOT_FOUND	404	Ruta desconocida, o la moneda / el exchange / el fondo solicitado no existe.	No reintente; compruebe la ruta y los identificadores en el catálogo.
RATE_LIMITED	429	Más solicitudes que el límite por minuto. `Retry-After` indica los segundos de espera.	Espere el tiempo de `Retry-After` y después reintente con espera progresiva.
INTERNAL	500	Error inesperado del servidor. El mensaje es genérico por diseño; cite `request_id` al informar del error.	Reintente una vez tras unos segundos; si persiste, infórmelo con el ID de solicitud.
UPSTREAM_FAILED	503	La fuente de datos de este endpoint no respondió a tiempo. No se devuelven cifras desactualizadas ni sustitutas en su lugar.	Reintente con espera progresiva; consulte la página de estado.
UNAVAILABLE	501 / 503	El conjunto de datos no está listo temporalmente (calentamiento de la caché) o el endpoint aún no tiene una fuente pública lícita.	Reintente más tarde; el catálogo marca los endpoints que no están disponibles por diseño.
REQUEST_FAILED	200	Algunos endpoints antiguos responden HTTP 200 con `success: false`. Compruebe siempre `success`, no solo el estado HTTP.	Depende del mensaje; trátelo como una solicitud fallida.

Pruébelo

GET/api/cftc/cotDisponible

Parámetros

currency

string · por defecto BTC — Underlying; anything other than ETH is BTC.

URL de la solicitudhttps://www.coinboss.com/api/cftc/cot?currency=BTC

Elija un endpoint y pulse «Enviar solicitud». Aquí aparecerán la respuesta, las cabeceras y los tiempos.

Posicionamiento CFTC (futuros cripto de CME) /api/sd/cme/cot
Resumen de futuros de CME /api/sd/cme/overview
Commitments of Traders de la CFTC /api/cftc/cot