Estado del servicio
Estado general, instancias y almacenes de la API, endpoints con fallos, percentiles de latencia, disponibilidad a 30 días, salud de los recolectores por familia de datos e incidentes abiertos.
/api/meta/statusSolicitud
Este endpoint no admite parámetros.
Solicitud de ejemplo
curl -s "https://www.coinboss.com/api/meta/status"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 del esquema de esta respuesta (`coinboss.meta.status/1`). |
| now | number | ms | Hora del servidor en el momento de generar la respuesta. |
| overall | string | — | Estado general del servicio: `operational`, `degraded`, `partial_outage`, `major_outage` o `unknown`; véase `legend`. |
| api_version | string | — | Versión de la API pública (`v1`). |
| catalog_version | string | — | Versión del catálogo de endpoints, una fecha de publicación como `2026.11.11`. |
| components | array | — | Componentes del servicio con su estado: API REST, flujo WebSocket, base de datos, caché, almacén de series temporales, sonda de endpoints y recopilación de datos. |
| components[] | object | — | Un componente: `id`, `title`, `status` y un objeto `detail` cuyos campos dependen del componente. |
| components[].id | string | — | Identificador. |
| components[].title | string | — | Nombre para mostrar del componente. |
| components[].status | string | — | Estado. |
| components[].detail | object | — | Detalle. |
| components[].detail.instances_healthy | number | count | Instancias del servidor de la API que respondieron a la comprobación de salud en este momento. puede faltar |
| components[].detail.instances_total | number | count | Instancias del servidor de la API que se comprobaron. puede faltar |
| components[].detail.health_latency_ms | number | ms | Respuesta más lenta a la comprobación de salud entre las instancias de la API. puede faltar |
| components[].detail.last_check_at | number | ms | Marca de tiempo. puede faltar |
| components[].detail.first_frame_ms | number | ms | Tiempo transcurrido desde la conexión al flujo WebSocket hasta la llegada de la primera trama en el último sondeo; null cuando no se sondeó. puede faltar |
| components[].detail.ping_ms | number | ms | Tiempo de ida y vuelta de una consulta trivial al componente (base de datos, caché o almacén de series temporales), medido desde el host de la API. puede faltar |
| components[].detail.note | null | — | Nota. puede faltar |
| components[].detail.last_run_at | number | ms | Marca de tiempo. puede faltar |
| components[].detail.age_s | number | s | Segundos transcurridos desde la última actualización de esta fila. puede faltar |
| components[].detail.interval_s | number | s | Intervalo previsto entre dos ejecuciones de la sonda (300). puede faltar |
| components[].detail.took_ms | number | ms | Duración de la última ejecución completa de la sonda; null cuando no se registró. puede faltar |
| components[].detail.families_total | number | count | Número de familias de datos evaluadas para la recopilación de datos. puede faltar |
| components[].detail.families_degraded | number | count | Número de familias de datos cuyo estado de recopilación es `degraded` u `outage`. puede faltar |
| components[].detail.judged_by | string | — | Marca de tiempo a partir de la cual se evaluó el estado. puede faltar |
| endpoints | object | — | Número de endpoints documentados en cada estado en vivo, más la lista de los que fallan. |
| endpoints.total | number | — | Total. |
| endpoints.available | number | — | Indica si hay datos disponibles. |
| endpoints.partial | number | — | true cuando solo está presente una parte de los datos esperados. |
| endpoints.degraded | number | count | Número de endpoints cuyo estado en vivo es `degraded`. |
| endpoints.down | number | count | Número de endpoints cuyo estado en vivo es `down`. |
| endpoints.unavailable | number | — | Elementos para los que no hay datos disponibles, con sus motivos. Nunca se informan como 0. |
| endpoints.unknown | number | count | Número de endpoints cuyo estado en vivo es `unknown` (sin resultado reciente de la sonda). |
| endpoints.failing | array | — | Endpoints actualmente en `down` o `degraded`, cada uno con `id`, `path`, `status`, `reason`, último estado HTTP, hora del último éxito y racha de fallos. |
| endpoints.failing[] | object | — | Un endpoint que actualmente está caído o degradado. |
| endpoints.failing[].id | string | — | Identificador. |
| endpoints.failing[].path | string | — | Ruta del endpoint. |
| endpoints.failing[].status | string | — | Estado. |
| endpoints.failing[].reason | string | — | Código de motivo. |
| endpoints.failing[].http | number | — | Estado HTTP del último sondeo; `null` cuando nunca se ha sondeado. |
| endpoints.failing[].last_ok_at | number | ms | Marca de tiempo. |
| endpoints.failing[].fail_streak | number | count | Número de sondeos fallidos consecutivos. |
| latency_ms | object | — | Distribución del tiempo de respuesta de la última llamada correcta de la sonda a cada endpoint, medida en el host de la API. |
| latency_ms.p50 | number | ms | Mediana del tiempo de respuesta entre los endpoints; null cuando no hay ninguna muestra fresca. |
| latency_ms.p95 | number | ms | Percentil 95 del tiempo de respuesta entre los endpoints; null cuando no hay ninguna muestra fresca. |
| latency_ms.max | number | — | Máximo. |
| latency_ms.sample | number | count | Número de endpoints incluidos en las cifras de latencia. |
| latency_ms.measured | string | — | Nota en texto plano sobre dónde se mide la latencia: en el lado del servidor, sin incluir el tránsito de red. |
| uptime | object | — | Comprobaciones de la sonda sobre todos los endpoints en conjunto durante la ventana: totales, porcentaje de éxito y un desglose por día. |
| uptime.window_days | number | days | Duración de la ventana de disponibilidad (30). |
| uptime.checks | number | count | Número de comprobaciones de la sonda en la ventana, todos los endpoints en conjunto. |
| uptime.ok | number | count | Número de esas comprobaciones que tuvieron éxito. |
| uptime.pct | number | % | Porcentaje. |
| uptime.tracking_since | string | — | Primer día con datos de la sonda dentro de la ventana, `YYYY-MM-DD`; null cuando aún no hay datos. |
| uptime.days | array | — | Valores diarios o número de días. |
| uptime.days[] | object | — | Valores diarios o número de días. |
| uptime.days[].day | string | — | Día de calendario (UTC). |
| uptime.days[].checks | number | count | Número de solicitudes de sonda ese día. |
| uptime.days[].ok | number | count | Número de solicitudes de sonda correctas ese día. |
| uptime.days[].pct | number | % | Porcentaje. |
| uptime.days[].schema_pct | number | % | Proporción de las respuestas sondeadas ese día que coincidieron con la tabla de campos documentada. |
| uptime.days[].avg_ms | number | ms | Tiempo medio de respuesta ese día. |
| collectors | object | — | Estado de la recopilación de datos de los exchanges, evaluado a partir de las marcas de tiempo de los datos almacenados: recuentos por familia, comprobaciones de conjuntos de datos y salud de la patrulla; null cuando no puede evaluarse. |
| collectors.families | array | — | Estado de la recopilación por familia de datos. |
| collectors.families[] | object | — | Una familia: `family`, `title`, número de exchanges en cada estado y el `status` resultante. |
| collectors.families[].family | string | — | Id de la familia, por ejemplo `ticker`, `oi`, `funding`, `liquidation`, `options`. |
| collectors.families[].title | string | — | Título para mostrar de la familia. |
| collectors.families[].exchanges_collected | number | count | Exchanges para los que se recopila la familia: fresh + partial + stale + broken. |
| collectors.families[].fresh | number | count | Exchanges cuyos datos más recientes de la familia están dentro de la ventana de frescura. |
| collectors.families[].partial | number | — | true cuando solo está presente una parte de los datos esperados. |
| collectors.families[].stale | number | — | Filas o indicador de datos más antiguos que la ventana de frescura. |
| collectors.families[].broken | number | count | Exchanges cuyo origen sigue fallando o cuyas filas, en su mayoría, no superan las comprobaciones de coherencia de la familia. |
| collectors.families[].unavailable | number | — | Elementos para los que no hay datos disponibles, con sus motivos. Nunca se informan como 0. |
| collectors.families[].status | string | — | Estado. |
| collectors.datasets | array | — | Comprobaciones de calidad de los conjuntos de datos que no son por exchange (por ejemplo, los datos diarios de ETF spot y de CME), cada una con estado, retraso, cobertura y motivo. |
| collectors.datasets[] | object | — | Un conjunto de datos de todo el mercado que no está ligado a un único exchange (opciones, ETF spot, CME, libros de órdenes, base). |
| collectors.datasets[].family | string | — | Id del conjunto de datos, por ejemplo `etf` o `cme`. |
| collectors.datasets[].id | string | — | Identificador. |
| collectors.datasets[].title | string | — | Nombre para mostrar del conjunto de datos. |
| collectors.datasets[].source | string | — | De dónde procede el valor. |
| collectors.datasets[].endpoint | string | — | Endpoint público que sirve el conjunto de datos. |
| collectors.datasets[].status | string | — | Estado. |
| collectors.datasets[].lag_s | number | s | Antigüedad del punto de datos más reciente cuando se generó la respuesta. |
| collectors.datasets[].source_at | number | ms | Marca de tiempo. |
| collectors.datasets[].fetched_at | number | ms | Cuándo obtuvo CoinBoss los datos de la fuente. |
| collectors.datasets[].fresh_within_s | number | s | Ventana de frescura: los datos más recientes que este valor cuentan como frescos. |
| collectors.datasets[].coverage | object | — | Qué se incluye y qué falta. |
| collectors.datasets[].coverage.funds_total | number | count | Número de fondos con seguimiento. puede faltar |
| collectors.datasets[].coverage.funds_covered | number | count | Número de fondos con una divulgación utilizable. puede faltar |
| collectors.datasets[].coverage.funds_unavailable | number | count | Número de fondos cuyo emisor no publica ninguna divulgación legible por máquina. puede faltar |
| collectors.datasets[].coverage.funds_failing | number | count | Número de fondos cuya divulgación no pudo leerse en la última ronda de recopilación. puede faltar |
| collectors.datasets[].coverage.as_of | string | — | Fecha de divulgación más reciente entre los fondos cubiertos (YYYY-MM-DD). puede faltar |
| collectors.datasets[].coverage.as_of_min | string | — | Fecha de divulgación más antigua entre los fondos cubiertos (YYYY-MM-DD). puede faltar |
| collectors.datasets[].reason | string|null | — | Código de motivo. |
| collectors.datasets[].coverage.contracts | number | — | Filas por contrato. puede faltar |
| collectors.datasets[].coverage.report_date | string | — | Fecha del informe Commitments of Traders de la CFTC más reciente (YYYY-MM-DD). puede faltar |
| collectors.datasets[].coverage.products | number | count | Número de productos de CME cubiertos. puede faltar |
| collectors.datasets[].coverage.trade_date | string | — | Fecha de negociación del informe diario de CME más reciente (YYYY-MM-DD). puede faltar |
| collectors.patrol_ok | boolean | — | true cuando la patrulla de calidad de datos se ejecutó en los últimos 15 minutos. |
| collectors.patrol_age_s | number | s | Segundos transcurridos desde el evento. |
| collectors.evaluated_at | number | ms | Marca de tiempo. |
| incidents | object | — | Alertas de calidad de datos que están abiertas o se resolvieron en los últimos 7 días: recuento `open` e `items` (100 como máximo). |
| incidents.open | number | — | Precio de apertura del periodo. |
| incidents.items | array | — | Elementos del resultado. |
| incidents.items[] | object | — | Elementos del resultado. |
| incidents.items[].level | string | — | Nivel. |
| incidents.items[].exchange | string | — | Id del exchange, en minúsculas (por ejemplo `binance`). |
| incidents.items[].family | string | — | Familia de datos a la que se refiere la alerta. |
| incidents.items[].code | string | — | Código. |
| incidents.items[].detail | string | — | Detalle. |
| incidents.items[].opened_at | number | ms | Marca de tiempo. |
| incidents.items[].last_seen_at | number | ms | Marca de tiempo. |
| incidents.items[].resolved_at | number|null | ms | Marca de tiempo. |
| incidents.items[].hits | number | count | Número de ejecuciones de la patrulla (una cada 5 minutos) que observaron la condición desde que se abrió la alerta. |
| incidents.items[].open | boolean | — | Precio de apertura del periodo. |
| probe | object | — | Estado de la sonda de endpoints en la que se basan los estados en vivo: hora de la última ejecución, su antigüedad, el intervalo y si es fresca. |
| probe.last_run_at | number | ms | Marca de tiempo. |
| probe.age_s | number | s | Segundos transcurridos desde la última actualización de esta fila. |
| probe.interval_s | number | s | Intervalo previsto entre dos ejecuciones de la sonda (300). |
| probe.fresh | boolean | — | true cuando la última ejecución de la sonda tiene menos de 20 minutos; cuando es false, los estados de los endpoints se notifican como `unknown`. |
| probe.error | null | — | Mensaje de error (presente solo en caso de fallo). |
| probe.endpoints_checked | number | count | Número de endpoints comprobados en la última ronda de la sonda. |
| probe.ok | number | count | Número de endpoints que respondieron correctamente en la última ronda de la sonda. |
| probe.failed | number | count | Número de endpoints que fallaron en la última ronda de la sonda. |
| probe.schema_mismatch | number | count | Número de endpoints cuya respuesta no coincidió con la tabla de campos documentada. |
| probe.alt_samples_failed | null | count | Número de solicitudes de muestra adicionales que fallaron; `null` cuando la última ronda no las ejecutó. |
| legend | object | — | Definición en texto plano de cada valor de `overall`. |
| legend.operational | string | — | Definición de `operational`. |
| legend.degraded | string | — | Definición de `degraded`. |
| legend.partial_outage | string | — | Definición de `partial_outage`. |
| legend.major_outage | string | — | Definición de `major_outage`. |
| legend.unknown | string | — | Definición de `unknown`. |
| meta | object | — | Envoltorio de esta respuesta: id del esquema, sistema que la produce, marcas de tiempo, duración de la caché y frescura. |
| meta.schema | string | — | Id del esquema de esta respuesta; el mismo valor que el `schema` de nivel superior. |
| meta.source | array | — | De dónde procede el valor. |
| meta.source[] | object | — | De dónde procede el valor. |
| meta.source[].system | string | — | Sistema que produjo los datos; siempre `coinboss` en los endpoints del centro de desarrolladores. |
| meta.source[].component | string | — | Componente del que proceden los datos: la sonda de endpoints y la patrulla de calidad de datos. |
| meta.observed_at | null | — | Marca de tiempo. |
| meta.received_at | number | ms | Marca de tiempo. |
| meta.fetched_at | number | ms | Cuándo obtuvo CoinBoss los datos de la fuente. |
| meta.window | string | — | Ventana. |
| meta.cache_ttl_s | number | s | Duración de la caché del lado del servidor para esta respuesta. |
| meta.quality | string | — | `FRESH` cuando la sonda de endpoints informó en los últimos 20 minutos; en caso contrario, `STALE`. |
| meta.is_stale | boolean | — | true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales. |
| meta.fallback | string | — | Nota en texto plano sobre lo que devuelve este endpoint cuando sus datos de entrada están desactualizados o faltan. |
Generada 2026-11-11 23:01 UTC a partir de 1 respuestas reales.
Respuesta de ejemplo
/api/meta/status · Respuesta real capturada 2026-11-13 03:53:47 UTC. Los arrays y mapas largos se abrevian para su visualización: components tenía 7 elementos; uptime.days tenía 3 elementos; incidents.items tenía 11 elementos; endpoints.failing tenía 25 elementos; collectors.datasets tenía 12 elementos; collectors.families tenía 12 elementos.
- "success"true
- "schema""coinboss.meta.status/1"
- "now"1794542027137
- "overall""partial_outage"
- "api_version""v1"
- "catalog_version""2026.11.12"
- "components"
- "endpoints"
- "total"299
- "available"256
- "partial"17
- "degraded"17
- "down"8
- "unavailable"1
- "unknown"0
- "failing"
- "latency_ms"
- "p50"7
- "p95"839
- "max"10047
- "sample"289
- "measured""server-side, from the probe on the API host (excludes network transit)"
- "uptime"
- "window_days"30
- "checks"119504
- "ok"118277
- "pct"98.97
- "tracking_since""2026-11-11"
- "days"
- "collectors"
- "families"
- "datasets"
- "patrol_ok"true
- "patrol_age_s"282
- "evaluated_at"1794542027976
- "incidents"
- "open"2
- "items"
- "probe"
- "last_run_at"1794541726312
- "age_s"301
- "interval_s"300
- "fresh"true
- "error"null
- "endpoints_checked"290
- "ok"289
- "failed"1
- "schema_mismatch"0
- "alt_samples_failed"null
- "legend"
- "operational""all checks pass"
- "degraded""serving, with stale data, schema drift or reduced redundancy"
- "partial_outage""at least one endpoint or API instance is failing"
- "major_outage""database down, no API instance healthy, or 20%+ of endpoints failing"
- "unknown""the probe has not reported within 20 minutes — status cannot be asserted"
- "meta"
- "schema""coinboss.meta.status/1"
- "source"
- "observed_at"null
- "received_at"1794541726312
- "fetched_at"1794542027137
- "window""latest"
- "cache_ttl_s"15
- "quality""FRESH"
- "is_stale"false
- "fallback""status is \"unknown\" whenever the probe is stale; process liveness is never used as evidence"
Detalles
- Autenticación
- Ninguna. Endpoint público.
- Límite de solicitudes
- 1200 solicitudes por minuto por IP
- Caché del servidor
- 15s
- Microcaché de borde
- 10s
- Frecuencia de actualización
- Se evalúa bajo demanda; los resultados de los endpoints proceden de la sonda de la API de cada 5 minutos; la salud de los recolectores, de las marcas de tiempo de los datos.
- Fuentes de datos
- Resultados de la sonda de la API, comprobaciones de salud por instancia, matriz de calidad de los datos, registro de alertas.
- 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
Disponibilidad, últimos 30 días
99.75% de 407 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/meta/statusDisponibleSin parámetros.
https://www.coinboss.com/api/meta/statusMás en esta categoría
- Matriz de calidad de datos (vista del recolector) /api/sd/quality
- Catálogo de la API /api/meta/catalog
- Registro de cambios y política de versionado /api/meta/changelog
- Documentación de un endpoint /api/meta/endpoint
- Documento OpenAPI /api/meta/openapi
- Matriz de calidad de datos /api/meta/quality
- Estado del servicio /api/meta/status
- Comprueba si la plataforma conoce un símbolo de moneda /api/coin-exists
- Mapa de símbolo de moneda a ruta del icono alojado localmente /api/coin-icons
- Resumen agregado de la página de moneda /api/content/coin
- Resumen de secciones de todo el sitio /api/content/summary
- Tabla de tipos de cambio fiat /api/currency/fx
- Mapa de id de exchange a ruta del icono alojado localmente /api/exchange-icons
- Comprobación de actividad /api/health
- Estadísticas de la página de investigación /api/research/stats