GETDisponibleFRESH
Posicionamiento CFTC (futuros cripto de CME)
Serie semanal del informe Commitments of Traders para los futuros cripto de CME: posiciones largas, cortas, de spread y netas de intermediarios (dealers), gestores de activos, fondos apalancados, otros declarantes y no declarantes.
GET
/api/sd/cme/cotSolicitud
Parámetros de consulta
| Nombre | Tipo | Obligatorio | Valor por defecto | Valores admitidos | Descripción |
|---|---|---|---|---|---|
| coin | string | Obligatorio | — | — | Símbolo de la moneda: `BTC`, `ETH`, `SOL` o `XRP`. Ejemplo: BTC |
| range | string | Opcional | 1y | 3m, 6m, 1y, 3y, all | Rango retrospectivo; un punto por informe semanal. |
| unit | string | Opcional | coin | coin, contracts, usd | Unidad de los campos de posición. `contracts` requiere `contract`, porque no se pueden sumar contratos de distinto tamaño. |
| contract | string | Opcional | — | — | Un producto de CME de la moneda (por ejemplo `BTC` o `MBT`). Por defecto: todos los productos de la moneda, convertidos a moneda y sumados. |
Solicitud de ejemplo
curl -s "https://www.coinboss.com/api/sd/cme/cot?coin=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 }`. |
| schema | string | — | Id de esquema de esta respuesta. Solo cambia cuando un campo existente cambia de significado o de tipo. |
| now | number | ms | Hora del servidor en el momento de generar la respuesta. |
| coin | string | — | Símbolo de la moneda (en mayúsculas). |
| range | string | — | Rango retrospectivo aplicado. |
| unit | string | — | Unidad de los campos de posición: `coin`, `contracts` o `usd`. |
| contract | null | — | Producto de CME seleccionado, o `null` para todos los productos de la moneda. |
| report_date | string | — | Fecha de referencia del informe de la CFTC (normalmente un martes). |
| contracts | array | — | Productos de CME incluidos. |
| contracts[] | string | — | Productos de CME incluidos. |
| multipliers | object | — | Monedas por contrato, por producto (la clave es el código del producto). claves dinámicas: BTC,MBT |
| multipliers.{*} | number | — | Monedas por contrato, por producto (la clave es el código del producto). |
| points | number | — | Puntos de la serie, del más antiguo al más reciente. |
| latest | object | — | Informe semanal más reciente. |
| latest.date | string | — | Fecha de referencia del informe semanal. |
| latest.contracts | array | — | Productos de CME incluidos. |
| latest.contracts[] | string | — | Productos de CME incluidos. |
| latest.oi | number | — | Interés abierto total del informe, en la unidad seleccionada. |
| latest.dealer_long | number | — | Posiciones largas de dealers / intermediarios. |
| latest.dealer_short | number | — | Posiciones cortas de dealers / intermediarios. |
| latest.dealer_spread | number | — | Posiciones largas y cortas compensadas de los dealers; no se incluyen en largos ni en cortos. |
| latest.dealer_net | number | — | Dealers: largos − cortos. |
| latest.asset_mgr_long | number | — | Posiciones largas de gestores de activos / institucionales. |
| latest.asset_mgr_short | number | — | Posiciones cortas de gestores de activos / institucionales. |
| latest.asset_mgr_spread | number | — | Posiciones compensadas de los gestores de activos; no se incluyen en largos ni en cortos. |
| latest.asset_mgr_net | number | — | Gestores de activos: largos − cortos. |
| latest.lev_money_long | number | — | Posiciones largas de fondos apalancados. |
| latest.lev_money_short | number | — | Posiciones cortas de fondos apalancados. |
| latest.lev_money_spread | number | — | Posiciones compensadas de los fondos apalancados; no se incluyen en largos ni en cortos. |
| latest.lev_money_net | number | — | Fondos apalancados: largos − cortos. |
| latest.other_rept_long | number | — | Posiciones largas de otros operadores declarantes. |
| latest.other_rept_short | number | — | Posiciones cortas de otros operadores declarantes. |
| latest.other_rept_spread | number | — | Posiciones compensadas de otros operadores declarantes; no se incluyen en largos ni en cortos. |
| latest.other_rept_net | number | — | Otros declarantes: largos − cortos. |
| latest.nonrept_long | number | — | Posiciones largas de operadores no declarantes (pequeños). |
| latest.nonrept_short | number | — | Posiciones cortas de operadores no declarantes (pequeños). |
| latest.nonrept_net | number | — | No declarantes: largos − cortos. |
| series | array | — | Puntos semanales, del más antiguo al más reciente. |
| series[] | object | — | Puntos semanales, del más antiguo al más reciente. |
| series[].date | string | — | Fecha de referencia del informe semanal. |
| series[].contracts | array | — | Productos de CME incluidos. |
| series[].contracts[] | string | — | Productos de CME incluidos. |
| series[].oi | number | — | Interés abierto total del informe, en la unidad seleccionada. |
| series[].dealer_long | number | — | Posiciones largas de dealers / intermediarios. |
| series[].dealer_short | number | — | Posiciones cortas de dealers / intermediarios. |
| series[].dealer_spread | number | — | Posiciones largas y cortas compensadas de los dealers; no se incluyen en largos ni en cortos. |
| series[].dealer_net | number | — | Dealers: largos − cortos. |
| series[].asset_mgr_long | number | — | Posiciones largas de gestores de activos / institucionales. |
| series[].asset_mgr_short | number | — | Posiciones cortas de gestores de activos / institucionales. |
| series[].asset_mgr_spread | number | — | Posiciones compensadas de los gestores de activos; no se incluyen en largos ni en cortos. |
| series[].asset_mgr_net | number | — | Gestores de activos: largos − cortos. |
| series[].lev_money_long | number | — | Posiciones largas de fondos apalancados. |
| series[].lev_money_short | number | — | Posiciones cortas de fondos apalancados. |
| series[].lev_money_spread | number | — | Posiciones compensadas de los fondos apalancados; no se incluyen en largos ni en cortos. |
| series[].lev_money_net | number | — | Fondos apalancados: largos − cortos. |
| series[].other_rept_long | number | — | Posiciones largas de otros operadores declarantes. |
| series[].other_rept_short | number | — | Posiciones cortas de otros operadores declarantes. |
| series[].other_rept_spread | number | — | Posiciones compensadas de otros operadores declarantes; no se incluyen en largos ni en cortos. |
| series[].other_rept_net | number | — | Otros declarantes: largos − cortos. |
| series[].nonrept_long | number | — | Posiciones largas de operadores no declarantes (pequeños). |
| series[].nonrept_short | number | — | Posiciones cortas de operadores no declarantes (pequeños). |
| series[].nonrept_net | number | — | No declarantes: largos − cortos. |
| coverage | object | — | Qué se incluye y qué no en las cifras. Conviene revisarlo antes de comparar totales con otra fuente. |
| coverage.included_exchanges | array | — | Fuentes cuyos datos frescos se incluyen. |
| coverage.included_exchanges[] | string | — | Fuentes cuyos datos frescos se incluyen. |
| coverage.unavailable | array | — | Fuentes que no pudieron incluirse, cada una con su motivo. Nunca se cuentan como 0. vacío en las muestras usadas para generar esta tabla |
| coverage.stale_excluded | array | — | Filas excluidas porque su última actualización está fuera de la ventana de frescura. vacío en las muestras usadas para generar esta tabla |
| method | object | — | Enunciado en texto plano de las fórmulas utilizadas en esta respuesta, con una entrada por campo. |
| method.value | string | — | Nota de fórmula de `value`, en texto plano. |
| method.categories | string | — | Nota de fórmula de `categories`, en texto plano. |
| method.identity | string | — | Nota de fórmula de `identity`, en texto plano. |
| method.price | string | — | Nota de fórmula de `price`, en texto plano. |
| method.is_stale | string | — | Nota de fórmula de `is_stale`, en texto plano. |
| meta | object | — | Linaje y frescura de esta respuesta. |
| meta.schema | string | — | Id de esquema de esta respuesta. Solo cambia cuando un campo existente cambia de significado o de tipo. |
| meta.source | array | — | Endpoints públicos de origen de los que se recopilaron los datos. |
| meta.source[] | object | — | Endpoints públicos de origen de los que se recopilaron los datos. |
| meta.source[].exchange | string | — | Id del exchange (en minúsculas). |
| meta.source[].endpoint | string | — | Endpoint público de la fuente que lee el recolector (se muestra por linaje; los clientes nunca lo llaman). |
| meta.observed_at | number | ms | Marca de tiempo que la fuente asigna a los datos. |
| meta.received_at | number | ms | Hora en que el recolector de CoinBoss recibió los datos. |
| meta.fetched_at | number | ms | Hora en que se compuso esta respuesta. |
| meta.window | string | — | Ventana temporal que cubren las cifras. |
| meta.quality | string | — | FRESH, PARTIAL, STALE, BROKEN o UNAVAILABLE, según las marcas de tiempo de los datos y la cobertura. |
| meta.is_stale | boolean | — | True cuando los datos son más antiguos que su ventana de frescura. |
| meta.cache_ttl_s | number | s | Tiempo de vida en caché de esta respuesta. |
| meta.fallback | string | — | Qué devuelve el endpoint cuando falla el recolector o una fuente. |
| latest.price | number | USD | Precio usado para la conversión a USD. puede faltar |
| latest.price_src | string | — | De dónde procede `price`: el precio de liquidación del primer vencimiento de CME cuando se recopila; en otro caso, un precio de referencia diario etiquetado. puede faltar |
| series[].price | number | USD | Precio usado para la conversión a USD. puede faltar |
| series[].price_src | string | — | De dónde procede `price`: el precio de liquidación del primer vencimiento de CME cuando se recopila; en otro caso, un precio de referencia diario etiquetado. puede faltar |
Generada 2026-11-11 23:00 UTC a partir de 3 respuestas reales.
Respuesta de ejemplo
/api/sd/cme/cot?coin=BTC · Respuesta real capturada 2026-11-13 03:58:25 UTC. Los arrays y mapas largos se abrevian para su visualización: series tenía 51 elementos.
- "success"true
- "schema""coinboss.sd.cme/1"
- "now"1794542305751
- "coin""BTC"
- "range""1y"
- "unit""coin"
- "contract"null
- "report_date""2026-11-03"
- "contracts"
- "BTC"
- "MBT"
- "multipliers"
- "BTC"5
- "MBT"0.1
- "points"51
- "latest"
- "date""2026-11-03"
- "contracts"
- "oi"89918.8
- "dealer_long"30263.2
- "dealer_short"27953.8
- "dealer_spread"2450
- "dealer_net"2309.4
- "asset_mgr_long"22052.2
- "asset_mgr_short"9925.7
- "asset_mgr_spread"935
- "asset_mgr_net"12126.5
- "lev_money_long"26616.8
- "lev_money_short"40103.2
- "lev_money_spread"2148
- "lev_money_net"-13486.4
- "other_rept_long"1111.6
- "other_rept_short"1787.6
- "other_rept_spread"99.6
- "other_rept_net"-676
- "nonrept_long"4242.4
- "nonrept_short"4515.9
- "nonrept_net"-273.5
- "series"
- "coverage"
- "included_exchanges"
- "unavailable"
- "stale_excluded"
- "method"
- "value""CFTC Commitments of Traders, Traders in Financial Futures, futures only. Each series point is one weekly report (as-of Tuesday). unit=coin: contracts x multipli…"
- "categories""dealer = Dealer/Intermediary, asset_mgr = Asset Manager/Institutional, lev_money = Leveraged Funds, other_rept = Other Reportables, nonrept = Non-reportable; *_…"
- "identity""oi = sum of the four category longs + four category spreads + nonrept_long (and the same on the short side)"
- "price""unit=usd only: CME front-month final settlement of the report date when collected, otherwise reference spot price (price_src per point); null price gives null v…"
- "is_stale""now is more than 10 days past the scheduled release of the latest stored report (release = report_date + 3 days, 21:30 UTC upper bound for Friday 15:30 ET)"
- "meta"
- "schema""coinboss.sd.cme/1"
- "source"
- "observed_at"1793664000000
- "received_at"1794504008901
- "fetched_at"1794542305751
- "window""1y"
- "quality""FRESH"
- "is_stale"false
- "cache_ttl_s"300
- "fallback""on collector failure the last stored weekly report is served with its real report_date; flagged is_stale=true once 10 days have passed since its scheduled relea…"
Muestras verificadas
Además del ejemplo anterior, la sonda llama a este endpoint con estos parámetros y comprueba el esquema en cada ocasión.
| Parámetros | HTTP | Latencia | Resultado |
|---|---|---|---|
| coin=ETH&unit=usd | 200 | 7 ms | Correcto PARTIAL |
| coin=BTC&range=all | 200 | 15 ms | Correcto FRESH |
| coin=BTC&unit=contracts | 400 | 1 ms | Correcto devuelve el error esperado |
Comprobado 2026-11-13 03:58:25 UTC
Detalles
- Autenticación
- Ninguna. Endpoint público.
- Límite de solicitudes
- 1200 solicitudes por minuto por IP
- Caché del servidor
- 5m
- Microcaché de borde
- 10s
- Frecuencia de actualización
- Semanal. La fecha del informe es normalmente el martes y la CFTC lo publica el viernes; el recolector lo comprueba tres veces al día.
- Ventana
- 3m / 6m / 1y / 3y / all, puntos semanales.
- Fuentes de datos
- Informe Commitments of Traders de la CFTC, Traders in Financial Futures (solo futuros), recopilado y almacenado por CoinBoss (sd_cme_cot_weekly).
- Cobertura de exchanges
- BTC desde 2018-04-10, ETH desde 2021-04-06; SOL y XRP desde su listado en CME. Una semana en la que falta en el informe un producto de la moneda se marca como PARTIAL.
- Paginación
- Sin paginación; `range` limita el número de puntos.
- Ordenación
- Fecha del informe ascendente.
- Unidades
- Positions in coin by default (contracts × multiplier), or in contracts / USD with `unit`. With `unit=usd` each point carries the reference `price` and `price_src` used.
- Método
- net = long − short for every trader class. `*_spread` is the offsetting long-and-short position held by the same trader and is not included in long or short. Identity: Σ long + Σ spread + non-reportable long = open interest (and the same on the short side).
- Marcas de tiempo
- Milisegundos de época Unix (UTC), salvo que la descripción del campo indique otra cosa
- Formato de respuesta
- json
- Estabilidad
- Estable
- Disponible desde
- 2026-11-11
Estado en vivo
DisponibleComprobado 2026-11-13 03:58:25 UTCHTTP 2005 msEl esquema coincideAntigüedad del dato más reciente: 10.6h
Disponibilidad, últimos 30 días
100% de 406 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/sd/cme/cotDisponibleParámetros
string — Coin symbol: `BTC`, `ETH`, `SOL` or `XRP`.
string · por defecto 1y — Look-back range; one point per weekly report.
string · por defecto coin — Unit of the position fields. `contracts` requires `contract`, because contracts of different size cannot be added.
string — One CME product of the coin (for example `BTC` or `MBT`). Default: all products of the coin, converted to coin and summed.
URL de la solicitud
https://www.coinboss.com/api/sd/cme/cot?coin=BTCElija un endpoint y pulse «Enviar solicitud». Aquí aparecerán la respuesta, las cabeceras y los tiempos.
Más en esta categoría
- 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