GET /v1/fx/rates/:market/history
Consulta
Los ejemplos se ejecutan en el servidor. JavaScript y Python usan los clientes del inicio rápido; configura allí
COTIZAVE_API_KEY.
Dos formas de respuesta
Condate, se devuelve el último registro capturado antes de terminar ese día UTC. Puede corresponder a una captura anterior si ese día no tiene datos. date es la fecha solicitada; comprueba captured_at y updated_at.
Respuesta ilustrativa: las cifras y fechas no son cotizaciones actuales.
date, devuelve un objeto con points, incluso sin from y to; no un array en la raíz. Ejemplo de una colección con dos puntos:
Respuesta ilustrativa: las cifras y fechas no son cotizaciones actuales.
Granularidad y retención
daily devuelve la última captura disponible de cada día UTC. raw devuelve capturas individuales, con un máximo de 5.000: si se recorta, conserva las más recientes, las ordena cronológicamente, ajusta from y añade truncated: true. No rellenes huecos como si fueran observaciones nuevas.
La retención del plan no garantiza que cada mercado tenga datos para todo ese período. El inicio de cada serie y las interrupciones de la fuente limitan la cobertura efectiva. También se aplica el acceso por mercado.
Errores
400 para fechas, rango, granularidad o parámetros inválidos. 403 history_out_of_retention incluye details.max_days; 402 feature_not_in_plan para un mercado restringido. 404 cuando no hay registro puntual disponible. Una colección puede tener count: 0 y points: [].
Además pueden producirse los errores comunes de autenticación, cuota o disponibilidad. Las respuestas de error de la API son JSON; decide por code, no por el texto de message.
Gráficas y conciliación
Usacaptured_at como instante de observación y updated_at como fecha de la fuente. La unidad depende del mercado: eur_reference es VES/EUR; los mercados USD son VES/USD. Para graficar no mezcles ambas unidades.
Fechas y documentos
El histórico agrupa por captura UTC, no por la fecha local de Australia, Argentina o Venezuela. Una captura cercana no acredita la fecha valor requerida para una factura y el histórico no devuelveeffective_date. Conserva esa fecha y la tasa al emitir el documento; no las reconstruyas suponiendo que date significa fecha valor.