> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotizave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cobertura actual e histórica de tasas de cambio

> Comprueba si una tasa está publicada, accesible para tu plan y disponible en la fecha histórica que necesitas.

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](https://docs.cotizave.com/api/v2/coverage.md) explica los IDs publicados y la [matriz por plan](https://docs.cotizave.com/api/v2/rates-by-plan.md) 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.

| Plan | Antigüedad máxima |
| - | -: |
| Free | 3 días |
| Basic | 90 días |
| Growth | 180 días |
| Pro | 365 días |

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](https://docs.cotizave.com/api/v2/coverage.md) y la [matriz por plan](https://docs.cotizave.com/api/v2/rates-by-plan.md); 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](https://docs.cotizave.com/api/v2/history.md) o, si mantienes una integración anterior, [histórico V1 deprecado](https://docs.cotizave.com/api/endpoints/history.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.