/api/meta/status
GETDisponibleFRESH

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.

GET/api/meta/status

Solicitud

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.

CampoTipoUnidadDescripción
successboolean—true cuando la solicitud se completó correctamente. En caso de fallo, el cuerpo es `{ success: false, code, error, request_id }`.
schemastring—Id del esquema de esta respuesta (`coinboss.meta.status/1`).
nownumbermsHora del servidor en el momento de generar la respuesta.
overallstring—Estado general del servicio: `operational`, `degraded`, `partial_outage`, `major_outage` o `unknown`; véase `legend`.
api_versionstring—Versión de la API pública (`v1`).
catalog_versionstring—Versión del catálogo de endpoints, una fecha de publicación como `2026.11.11`.
componentsarray—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[].idstring—Identificador.
components[].titlestring—Nombre para mostrar del componente.
components[].statusstring—Estado.
components[].detailobject—Detalle.
components[].detail.instances_healthynumbercountInstancias del servidor de la API que respondieron a la comprobación de salud en este momento. puede faltar
components[].detail.instances_totalnumbercountInstancias del servidor de la API que se comprobaron. puede faltar
components[].detail.health_latency_msnumbermsRespuesta más lenta a la comprobación de salud entre las instancias de la API. puede faltar
components[].detail.last_check_atnumbermsMarca de tiempo. puede faltar
components[].detail.first_frame_msnumbermsTiempo 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_msnumbermsTiempo 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.notenull—Nota. puede faltar
components[].detail.last_run_atnumbermsMarca de tiempo. puede faltar
components[].detail.age_snumbersSegundos transcurridos desde la última actualización de esta fila. puede faltar
components[].detail.interval_snumbersIntervalo previsto entre dos ejecuciones de la sonda (300). puede faltar
components[].detail.took_msnumbermsDuración de la última ejecución completa de la sonda; null cuando no se registró. puede faltar
components[].detail.families_totalnumbercountNúmero de familias de datos evaluadas para la recopilación de datos. puede faltar
components[].detail.families_degradednumbercountNúmero de familias de datos cuyo estado de recopilación es `degraded` u `outage`. puede faltar
components[].detail.judged_bystring—Marca de tiempo a partir de la cual se evaluó el estado. puede faltar
endpointsobject—Número de endpoints documentados en cada estado en vivo, más la lista de los que fallan.
endpoints.totalnumber—Total.
endpoints.availablenumber—Indica si hay datos disponibles.
endpoints.partialnumber—true cuando solo está presente una parte de los datos esperados.
endpoints.degradednumbercountNúmero de endpoints cuyo estado en vivo es `degraded`.
endpoints.downnumbercountNúmero de endpoints cuyo estado en vivo es `down`.
endpoints.unavailablenumber—Elementos para los que no hay datos disponibles, con sus motivos. Nunca se informan como 0.
endpoints.unknownnumbercountNúmero de endpoints cuyo estado en vivo es `unknown` (sin resultado reciente de la sonda).
endpoints.failingarray—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[].idstring—Identificador.
endpoints.failing[].pathstring—Ruta del endpoint.
endpoints.failing[].statusstring—Estado.
endpoints.failing[].reasonstring—Código de motivo.
endpoints.failing[].httpnumber—Estado HTTP del último sondeo; `null` cuando nunca se ha sondeado.
endpoints.failing[].last_ok_atnumbermsMarca de tiempo.
endpoints.failing[].fail_streaknumbercountNúmero de sondeos fallidos consecutivos.
latency_msobject—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.p50numbermsMediana del tiempo de respuesta entre los endpoints; null cuando no hay ninguna muestra fresca.
latency_ms.p95numbermsPercentil 95 del tiempo de respuesta entre los endpoints; null cuando no hay ninguna muestra fresca.
latency_ms.maxnumber—Máximo.
latency_ms.samplenumbercountNúmero de endpoints incluidos en las cifras de latencia.
latency_ms.measuredstring—Nota en texto plano sobre dónde se mide la latencia: en el lado del servidor, sin incluir el tránsito de red.
uptimeobject—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_daysnumberdaysDuración de la ventana de disponibilidad (30).
uptime.checksnumbercountNúmero de comprobaciones de la sonda en la ventana, todos los endpoints en conjunto.
uptime.oknumbercountNúmero de esas comprobaciones que tuvieron éxito.
uptime.pctnumber%Porcentaje.
uptime.tracking_sincestring—Primer día con datos de la sonda dentro de la ventana, `YYYY-MM-DD`; null cuando aún no hay datos.
uptime.daysarray—Valores diarios o número de días.
uptime.days[]object—Valores diarios o número de días.
uptime.days[].daystring—Día de calendario (UTC).
uptime.days[].checksnumbercountNúmero de solicitudes de sonda ese día.
uptime.days[].oknumbercountNúmero de solicitudes de sonda correctas ese día.
uptime.days[].pctnumber%Porcentaje.
uptime.days[].schema_pctnumber%Proporción de las respuestas sondeadas ese día que coincidieron con la tabla de campos documentada.
uptime.days[].avg_msnumbermsTiempo medio de respuesta ese día.
collectorsobject—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.familiesarray—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[].familystring—Id de la familia, por ejemplo `ticker`, `oi`, `funding`, `liquidation`, `options`.
collectors.families[].titlestring—Título para mostrar de la familia.
collectors.families[].exchanges_collectednumbercountExchanges para los que se recopila la familia: fresh + partial + stale + broken.
collectors.families[].freshnumbercountExchanges cuyos datos más recientes de la familia están dentro de la ventana de frescura.
collectors.families[].partialnumber—true cuando solo está presente una parte de los datos esperados.
collectors.families[].stalenumber—Filas o indicador de datos más antiguos que la ventana de frescura.
collectors.families[].brokennumbercountExchanges cuyo origen sigue fallando o cuyas filas, en su mayoría, no superan las comprobaciones de coherencia de la familia.
collectors.families[].unavailablenumber—Elementos para los que no hay datos disponibles, con sus motivos. Nunca se informan como 0.
collectors.families[].statusstring—Estado.
collectors.datasetsarray—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[].familystring—Id del conjunto de datos, por ejemplo `etf` o `cme`.
collectors.datasets[].idstring—Identificador.
collectors.datasets[].titlestring—Nombre para mostrar del conjunto de datos.
collectors.datasets[].sourcestring—De dónde procede el valor.
collectors.datasets[].endpointstring—Endpoint público que sirve el conjunto de datos.
collectors.datasets[].statusstring—Estado.
collectors.datasets[].lag_snumbersAntigüedad del punto de datos más reciente cuando se generó la respuesta.
collectors.datasets[].source_atnumbermsMarca de tiempo.
collectors.datasets[].fetched_atnumbermsCuándo obtuvo CoinBoss los datos de la fuente.
collectors.datasets[].fresh_within_snumbersVentana de frescura: los datos más recientes que este valor cuentan como frescos.
collectors.datasets[].coverageobject—Qué se incluye y qué falta.
collectors.datasets[].coverage.funds_totalnumbercountNúmero de fondos con seguimiento. puede faltar
collectors.datasets[].coverage.funds_coverednumbercountNúmero de fondos con una divulgación utilizable. puede faltar
collectors.datasets[].coverage.funds_unavailablenumbercountNúmero de fondos cuyo emisor no publica ninguna divulgación legible por máquina. puede faltar
collectors.datasets[].coverage.funds_failingnumbercountNúmero de fondos cuya divulgación no pudo leerse en la última ronda de recopilación. puede faltar
collectors.datasets[].coverage.as_ofstring—Fecha de divulgación más reciente entre los fondos cubiertos (YYYY-MM-DD). puede faltar
collectors.datasets[].coverage.as_of_minstring—Fecha de divulgación más antigua entre los fondos cubiertos (YYYY-MM-DD). puede faltar
collectors.datasets[].reasonstring|null—Código de motivo.
collectors.datasets[].coverage.contractsnumber—Filas por contrato. puede faltar
collectors.datasets[].coverage.report_datestring—Fecha del informe Commitments of Traders de la CFTC más reciente (YYYY-MM-DD). puede faltar
collectors.datasets[].coverage.productsnumbercountNúmero de productos de CME cubiertos. puede faltar
collectors.datasets[].coverage.trade_datestring—Fecha de negociación del informe diario de CME más reciente (YYYY-MM-DD). puede faltar
collectors.patrol_okboolean—true cuando la patrulla de calidad de datos se ejecutó en los últimos 15 minutos.
collectors.patrol_age_snumbersSegundos transcurridos desde el evento.
collectors.evaluated_atnumbermsMarca de tiempo.
incidentsobject—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.opennumber—Precio de apertura del periodo.
incidents.itemsarray—Elementos del resultado.
incidents.items[]object—Elementos del resultado.
incidents.items[].levelstring—Nivel.
incidents.items[].exchangestring—Id del exchange, en minúsculas (por ejemplo `binance`).
incidents.items[].familystring—Familia de datos a la que se refiere la alerta.
incidents.items[].codestring—Código.
incidents.items[].detailstring—Detalle.
incidents.items[].opened_atnumbermsMarca de tiempo.
incidents.items[].last_seen_atnumbermsMarca de tiempo.
incidents.items[].resolved_atnumber|nullmsMarca de tiempo.
incidents.items[].hitsnumbercountNúmero de ejecuciones de la patrulla (una cada 5 minutos) que observaron la condición desde que se abrió la alerta.
incidents.items[].openboolean—Precio de apertura del periodo.
probeobject—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_atnumbermsMarca de tiempo.
probe.age_snumbersSegundos transcurridos desde la última actualización de esta fila.
probe.interval_snumbersIntervalo previsto entre dos ejecuciones de la sonda (300).
probe.freshboolean—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.errornull—Mensaje de error (presente solo en caso de fallo).
probe.endpoints_checkednumbercountNúmero de endpoints comprobados en la última ronda de la sonda.
probe.oknumbercountNúmero de endpoints que respondieron correctamente en la última ronda de la sonda.
probe.failednumbercountNúmero de endpoints que fallaron en la última ronda de la sonda.
probe.schema_mismatchnumbercountNúmero de endpoints cuya respuesta no coincidió con la tabla de campos documentada.
probe.alt_samples_failednullcountNúmero de solicitudes de muestra adicionales que fallaron; `null` cuando la última ronda no las ejecutó.
legendobject—Definición en texto plano de cada valor de `overall`.
legend.operationalstring—Definición de `operational`.
legend.degradedstring—Definición de `degraded`.
legend.partial_outagestring—Definición de `partial_outage`.
legend.major_outagestring—Definición de `major_outage`.
legend.unknownstring—Definición de `unknown`.
metaobject—Envoltorio de esta respuesta: id del esquema, sistema que la produce, marcas de tiempo, duración de la caché y frescura.
meta.schemastring—Id del esquema de esta respuesta; el mismo valor que el `schema` de nivel superior.
meta.sourcearray—De dónde procede el valor.
meta.source[]object—De dónde procede el valor.
meta.source[].systemstring—Sistema que produjo los datos; siempre `coinboss` en los endpoints del centro de desarrolladores.
meta.source[].componentstring—Componente del que proceden los datos: la sonda de endpoints y la patrulla de calidad de datos.
meta.observed_atnull—Marca de tiempo.
meta.received_atnumbermsMarca de tiempo.
meta.fetched_atnumbermsCuándo obtuvo CoinBoss los datos de la fuente.
meta.windowstring—Ventana.
meta.cache_ttl_snumbersDuración de la caché del lado del servidor para esta respuesta.
meta.qualitystring—`FRESH` cuando la sonda de endpoints informó en los últimos 20 minutos; en caso contrario, `STALE`.
meta.is_staleboolean—true cuando la fila es más antigua que la ventana de frescura; las filas desactualizadas no se usan en los totales.
meta.fallbackstring—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": [
      • { … 4 },
      • { … 4 }
      ],
    • "endpoints": {
      • "total": 299,
      • "available": 256,
      • "partial": 17,
      • "degraded": 17,
      • "down": 8,
      • "unavailable": 1,
      • "unknown": 0,
      • "failing": [ … 2 ]
      },
    • "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": [ … 2 ]
      },
    • "collectors": {
      • "families": [ … 2 ],
      • "datasets": [ … 2 ],
      • "patrol_ok": true,
      • "patrol_age_s": 282,
      • "evaluated_at": 1794542027976
      },
    • "incidents": {
      • "open": 2,
      • "items": [ … 2 ]
      },
    • "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": [ … 1 ],
      • "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

DisponibleComprobado 2026-11-13 03:53:47 UTCHTTP 200872 msEl esquema coincideAntigüedad del dato más reciente: 5m

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ódigoHTTPSignificadoQué hacer
INVALID_PARAM400Falta 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.
UNAUTHORIZED401Se 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.
FORBIDDEN403La ruta no forma parte de la API pública (interna o solo para cuentas).No reintente.
NOT_FOUND404Ruta desconocida, o la moneda / el exchange / el fondo solicitado no existe.No reintente; compruebe la ruta y los identificadores en el catálogo.
RATE_LIMITED429Má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.
INTERNAL500Error 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_FAILED503La 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.
UNAVAILABLE501 / 503El 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_FAILED200Algunos 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/meta/statusDisponible
Parámetros

Sin parámetros.

URL de la solicitudhttps://www.coinboss.com/api/meta/status
Elija un endpoint y pulse «Enviar solicitud». Aquí aparecerán la respuesta, las cabeceras y los tiempos.