Resumen de futuros de CME
Interés abierto y volumen diario de CME para una moneda, por producto (contratos estándar y micro), convertidos a nocional en moneda y en USD, además del último resumen de posicionamiento de la CFTC.
/api/sd/cme/overviewSolicitud
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` y `XRP` tienen productos de CME; otros símbolos válidos devuelven 200 con `meta.quality = "UNAVAILABLE"`. Ejemplo: BTC |
Solicitud de ejemplo
curl -s "https://www.coinboss.com/api/sd/cme/overview?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). |
| trade_date | string|null | — | Fecha de negociación de CME de las cifras. |
| oi_contracts | object|null | — | Interés abierto en contratos, por un solo lado. claves dinámicas: BTC,MBT |
| oi_contracts.{*} | number | contracts | Interés abierto en contratos, por un solo lado. |
| oi_coin | number|null | coin | Interés abierto en moneda: contratos × multiplicador del contrato. |
| oi_usd | number|null | USD | Interés abierto como nocional USD: moneda × `price`. |
| volume_contracts | object|null | — | Volumen total de la fecha de negociación en contratos (electrónico, de corro y fuera del exchange). claves dinámicas: BTC,MBT |
| volume_contracts.{*} | number | contracts | Volumen total de la fecha de negociación en contratos (electrónico, de corro y fuera del exchange). |
| volume_coin | number|null | coin | Volumen en moneda: contratos × multiplicador del contrato. |
| volume_usd | number|null | USD | Volumen como nocional USD: moneda × `price`. |
| price | number|null | USD | Precio usado para la conversión a USD. |
| price_src | string|null | — | 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. |
| products | array|null | — | Una fila por producto de CME de la moneda. |
| products[] | object | — | Una fila por producto de CME de la moneda. |
| products[].product | string | — | Código del producto de CME. |
| products[].name | string | — | Nombre del producto de CME. |
| products[].multiplier | number | coin | Monedas por contrato. |
| products[].oi_contracts | number | contracts | Interés abierto en contratos, por un solo lado. |
| products[].oi_coin | number | coin | Interés abierto en moneda: contratos × multiplicador del contrato. |
| products[].oi_usd | number | USD | Interés abierto como nocional USD: moneda × `price`. |
| products[].volume_contracts | number | contracts | Volumen total de la fecha de negociación en contratos (electrónico, de corro y fuera del exchange). |
| products[].globex_volume_contracts | number | contracts | Parte electrónica (Globex) del volumen. |
| products[].volume_coin | number | coin | Volumen en moneda: contratos × multiplicador del contrato. |
| products[].volume_usd | number | USD | Volumen como nocional USD: moneda × `price`. |
| products[].settle | null | USD | Precio de liquidación del primer vencimiento; `null` mientras no se recopile. |
| products[].settle_month | null | — | Mes de contrato del precio de liquidación. |
| products[].settle_src | null | — | Fuente del precio de liquidación. |
| cot | object|null | — | Resumen del último informe Commitments of Traders de la CFTC para la moneda. |
| cot.report_date | string | — | Fecha de referencia del informe de la CFTC (normalmente un martes). |
| cot.is_stale | boolean | — | True cuando los datos son más antiguos que su ventana de frescura. |
| cot.contracts | array | — | Productos de CME incluidos. |
| cot.contracts[] | string | — | Productos de CME incluidos. |
| cot.unit | string | — | Unidad de los campos de posición: `coin`, `contracts` o `usd`. |
| cot.oi_contracts | object | — | Interés abierto en contratos, por un solo lado. claves dinámicas: BTC,MBT |
| cot.oi_contracts.{*} | number | contracts | Interés abierto en contratos, por un solo lado. |
| cot.oi_coin | number | coin | Interés abierto en moneda: contratos × multiplicador del contrato. |
| cot.dealer_net | number | — | Dealers: largos − cortos. |
| cot.asset_mgr_net | number | — | Gestores de activos: largos − cortos. |
| cot.lev_money_net | number | — | Fondos apalancados: largos − cortos. |
| cot.other_rept_net | number | — | Otros declarantes: largos − cortos. |
| cot.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. |
| coverage.unavailable[] | object | — | Fuentes que no pudieron incluirse, cada una con su motivo. Nunca se cuentan como 0. |
| coverage.unavailable[].exchange | string | — | Id del exchange (en minúsculas). |
| coverage.unavailable[].field | string | — | Campo que falta. puede faltar |
| coverage.unavailable[].reason | string | — | Código de motivo legible por máquina. |
| coverage.unavailable[].detail | string | — | Explicación del motivo legible por personas. |
| 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.oi_contracts | string | — | Nota de fórmula de `oi_contracts`, en texto plano. |
| method.oi_coin | string | — | Nota de fórmula de `oi_coin`, en texto plano. |
| method.oi_usd | string | — | Nota de fórmula de `oi_usd`, en texto plano. |
| method.volume_contracts | string | — | Nota de fórmula de `volume_contracts`, en texto plano. |
| method.volume_usd | string | — | Nota de fórmula de `volume_usd`, en texto plano. |
| method.is_stale | string | — | Nota de fórmula de `is_stale`, en texto plano. |
| method.cot | string | — | Nota de fórmula de `cot`, 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|null | ms | Marca de tiempo que la fuente asigna a los datos. |
| meta.received_at | number|null | 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. |
Generada 2026-11-11 23:00 UTC a partir de 4 respuestas reales.
Respuesta de ejemplo
/api/sd/cme/overview?coin=BTC · Respuesta real capturada 2026-11-13 03:58:26 UTC. Los arrays y mapas largos se abrevian para su visualización: meta.source tenía 3 elementos.
- "success"true
- "schema""coinboss.sd.cme/1"
- "now"1794542306145
- "coin""BTC"
- "trade_date""2026-11-11"
- "oi_contracts"
- "BTC"19533
- "MBT"24382
- "oi_coin"100103.2
- "oi_usd"7409157367.61
- "volume_contracts"
- "BTC"8985
- "MBT"35304
- "volume_coin"48455.4
- "volume_usd"3586435637.53
- "price"74015.19
- "price_src""ref_binance_1d_close"
- "products"
- "cot"
- "report_date""2026-11-03"
- "is_stale"false
- "contracts"
- "unit""coin"
- "oi_contracts"
- "oi_coin"89918.8
- "dealer_net"2309.4
- "asset_mgr_net"12126.5
- "lev_money_net"-13486.4
- "other_rept_net"-676
- "nonrept_net"-273.5
- "coverage"
- "included_exchanges"
- "unavailable"
- "stale_excluded"
- "method"
- "oi_contracts""open interest in contracts (one-sided) per CME product, from the CME daily volume & open interest report"
- "oi_coin""sum over products of oi_contracts x contract multiplier (BTC 5, MBT 0.1, ETH 50, MET 0.1, SOL 500, MSL 25, XRP 50000, MXP 2500 coins per contract)"
- "oi_usd""oi_coin x price; price = CME front-month final settlement price when collected (price_src=cme_settle_front_month), otherwise a reference spot price for the same…"
- "volume_contracts""CME total volume for the trade date in contracts (Globex + pit + ex-pit + OTC/cleared); globex_volume_contracts is the Globex part"
- "volume_usd""volume in coins (contracts x multiplier) x the same price as oi_usd"
- "is_stale""trade_date 22:00 UTC is more than 120h old"
- "cot""latest CFTC Commitments of Traders (TFF, futures only) row(s) for the coin: positions converted to coins with the contract multiplier; net = long - short"
- "meta"
- "schema""coinboss.sd.cme/1"
- "source"
- "observed_at"1794434400000
- "received_at"1794504014502
- "fetched_at"1794542306145
- "window""latest"
- "quality""PARTIAL"
- "is_stale"false
- "cache_ttl_s"300
- "fallback""on collector failure the last stored CME trade date is served with its real trade_date; it is flagged is_stale=true once older than 120h; nothing is interpolate…"
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 | 200 | 5 ms | Correcto PARTIAL |
| coin=XRP | 200 | 5 ms | Correcto PARTIAL |
| coin=PEPE | 200 | 2 ms | Correcto UNAVAILABLE |
| — | 400 | 1 ms | Correcto devuelve el error esperado |
Comprobado 2026-11-13 03:58:26 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
- CME publica una vez por día de negociación; el recolector se ejecuta tres veces al día (04:20, 11:20, 17:20 UTC).
- Ventana
- Última fecha de negociación de CME (`trade_date`).
- Fuentes de datos
- Archivos del boletín diario de volumen e interés abierto de CME Group; Commitments of Traders de la CFTC (Traders in Financial Futures, solo futuros). Recopilados y almacenados por CoinBoss (sd_cme_daily, sd_cme_cot_weekly).
- Cobertura de exchanges
- Ocho productos de CME: BTC, MBT, ETH, MET, SOL, MSL, XRP, MXP. El interés abierto es por un solo lado, en contratos.
- Unidades
- Contracts are single-sided. Coin = contracts × contract multiplier (BTC 5, MBT 0.1, ETH 50, MET 0.1, SOL 500, MSL 25, XRP 50,000, MXP 2,500). USD notional = coin × `price`.
- Método
- oi_coin = Σ over products (open interest in contracts × multiplier); oi_usd = oi_coin × price. Volume is total daily volume (electronic, floor and off-exchange).
- 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
El endpoint informa de una calidad de datos PARTIAL — El interés abierto y el volumen en contratos y en moneda son cifras del exchange. El nocional USD usa actualmente un precio de referencia diario etiquetado (`price_src`) porque el precio de liquidación oficial de CME aún no se recopila; la carencia se lista en `coverage.unavailable` y la respuesta se marca como PARTIAL por ese motivo.
Disponibilidad, últimos 30 días
99.75% 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
/api/sd/cme/overviewParcialstring — Coin symbol. `BTC`, `ETH`, `SOL` and `XRP` have CME products; other valid symbols return 200 with `meta.quality = "UNAVAILABLE"`.
https://www.coinboss.com/api/sd/cme/overview?coin=BTCMá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