GEThttps://api.veriko.mx/v1/status/banxico/timeseries

Obtener la serie temporal pública de salud de Banxico

Audiencia
public
Autenticación
API key

Devuelve puntos de datos agrupados por intervalo de tiempo para la métrica y ventana solicitadas. La vista pública solo expone métricas seguras (probe_latency y verdict); los valores fuera de los enums no producen 422 — caen silenciosamente a los defaults (probe_latency, 24h). La respuesta se cachea 60 s en cliente. Requiere autenticación por API key sin permiso específico.

Parámetros
ParámetroUbicaciónTipoObligatorioDescripción
metricquerystringopcional

Métrica a recuperar. probe_latency devuelve la latencia en milisegundos; verdict devuelve el veredicto Banxico categórico por grupo.

Predeterminado: probe_latency

p. ej. probe_latency
windowquerystringopcional

Ventana que cubre la serie: 1h, 8h, 12h y 24h para mirar el día en curso con distinto detalle, y 7d para la semana. Como en el resto de las series, el intervalo se ajusta a la ventana pedida.

Predeterminado: 24h

p. ej. 24h
Petición
curl -X GET 'https://api.veriko.mx/v1/status/banxico/timeseries' \
  -H 'Authorization: Bearer veriko_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

Respuesta 200BanxicoPublicTimeseriesResponse — Puntos de datos de la serie temporal.
CampoTipoDescripción
dataobject

Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con type, id, attributes).

type*string

Tipo del recurso JSON:API. Siempre banxico_public_timeseries.

p. ej. banxico_public_timeseries
id*string

Identificador derivado del par métrica/ventana (<metric>_<window>).

p. ej. probe_latency_24h
attributes*object

Serie temporal de métricas de salud del servicio Banxico CEP en grupos de tiempo. Devuelto por GET /v1/banxico/timeseries.

metricstring

Métrica reportada: probe_latency — latencia de los health probes en milisegundos; verdict — distribución de veredictos Banxico por grupo.

p. ej. probe_latency
windowstring

Ventana de tiempo total cubierta por la serie (1h, 8h, 12h, 24h o 7d).

p. ej. 24h
unitstring

Unidad de medición de los valores: ms para probe_latency, verdict (entero 0/1/2) para verdict.

p. ej. ms
bucket_size_minutesinteger

Tamaño de cada grupo de tiempo en minutos.

p. ej. 30
pointsarray

Puntos de datos ordenados cronológicamente. Cada punto contiene ts (timestamp de inicio del grupo) y value (entero en ms para probe_latency, entero de veredicto 0/1/2 para verdict).

metaobject

Metadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC.

versionstring

Versión de la API que procesó la petición.

p. ej. 1.47.0
api_versionstring

Versión del prefijo de ruta de la API (ej. v1).

p. ej. v1
request_idstring

Identificador único de la petición (hex).

p. ej. a1b2c3d4e5f6
datetimeobject

Descriptor compañero presente en el bloque meta de cada respuesta (y en el meta del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec.

p. ej. {"timezone":"UTC","format":"ISO 8601"}
timezone*string

Siempre UTC — la zona canónica para cada campo datetime del cuerpo.

p. ej. UTC
format*string

Siempre ISO 8601 — sufijo Z explícito en cada datetime.

p. ej. ISO 8601
linksobject

Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

Códigos de respuestaGET /v1/status/banxico/timeseries
CódigoClaseDescripciónCuerpo
2002xxPuntos de datos de la serie temporal.BanxicoPublicTimeseriesResponse
4014xxSe requiere autenticación o las credenciales son inválidasErrorResponse
Cabeceras de respuesta200
CabeceraTipoDescripción
Cache-ControlstringTTL de caché para la vista pública.
VarystringVariación por Origin (CORS).
Errores de GET /v1/status/banxico/timeseries
CódigoClaveEjemplo
401unauthorized

Credenciales de autenticación ausentes o inválidas.

Envelope
meta.request_id
c4d5e6f7a8b9