Saltar al contenido principal
La cobertura no es solo una lista de monedas o países. Para usar una tasa hay que comprobar tres cosas: que tu plan pueda consultarla, que tenga una observación publicable y que exista histórico para la fecha requerida.

Cobertura actual

Una tasa puede estar registrada y, aun así, no tener una observación disponible en este instante. Comprueba siempre el recurso de tasas antes de mostrar o calcular con un valor:
  • En V2 multimercado, GET /v2/fx/{CC}/rates lista las tasas disponibles para país. Su catálogo V2 explica los IDs publicados y la matriz por plan indica el acceso a cada uno.
  • En V1 deprecada, GET /v1/fx/rates lista las tasas disponibles para tu API key. La sección de exportación del dashboard muestra además la cobertura histórica de las series a las que tienes acceso.
No construyas un ID desde un nombre comercial ni sustituyas una tasa por otra que comparta moneda.

Cobertura histórica

La antigüedad máxima consultable es la menor entre la retención de tu plan y la historia real de esa serie. La fecha de inicio aplica a cada serie, tanto en V1 como en V2: una serie puede haber empezado después, tener pausas o no publicar datos durante fines de semana y feriados. Estos límites se aplican a los endpoints de histórico. Si la fecha o el inicio del rango excede tu retención, la API responde 403 history_out_of_retention; el detalle del error identifica el límite que aplicó. Una serie conocida sin histórico puede responder 404 history_not_available; una fecha sin observación puede responder 404 rate_not_found.

Disponibilidad por mercado

La cobertura cambia según el país, la tasa y el plan. Consulta el catálogo V2 y la matriz por plan; usa el ID devuelto por la API para comprobar la observación actual y el rango histórico que necesitas. Una serie puede no publicar durante fines de semana, feriados u otros días sin captura.

Cómo comprobar una integración

  1. Consulta las tasas disponibles con el endpoint de tu versión.
  2. Conserva el ID exacto y revisa updated_at; cuando esté disponible, revisa también effective_date, stale y staleness_sec.
  3. Consulta el histórico con ese mismo ID y el rango requerido. No rellenes en tu aplicación los días que la serie no publicó.
  4. Trata 402 como falta de acceso de plan, 403 history_out_of_retention como un rango no permitido y los 404 de histórico como ausencia de serie u observación; no son errores que un reintento resuelva.
Consulta histórico V2 o, si mantienes una integración anterior, histórico V1 deprecado.