GET /v1/fx/bcv/currencies · Todos los planes. Cada valor expresa VES por unidad de la divisa indicada. USD está excluido; para USD oficial usa reference.
Consulta
Devuelve el último snapshot capturado, que puede anunciar una fecha valor futura. No requiere parámetros; admite formatos. La antigua ruta/v1/beta/fx/bcv/currencies fue retirada.
Los ejemplos se ejecutan en el servidor. JavaScript y Python usan los clientes del inicio rápido; configura allí COTIZAVE_API_KEY.
Respuesta
Respuesta ilustrativa: las cifras y fechas no son cotizaciones actuales.reference_value_date es la fecha valor publicada, en formato YYYY-MM-DD. reference_value_date_text conserva la etiqueta de la fuente, incluso al leer la documentación en inglés. rates es el mapa de divisa a valor; captured_at es la captura, no la entrada en vigor.
Publicación frente a vigencia
Puedes mostrar la próxima fecha valor indicando que aún no rige. Para convertir EUR con la referencia vigente usa/v1/fx/convert?from=EUR&to=VES&amount=100&via=eur_reference y revisa effective_date. No uses automáticamente la última publicación para una factura anterior a esa fecha.
Errores
404 bcv_snapshot_unavailable indica que no hay un snapshot disponible.
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.
Origen y precisión
Comparte el almacenamiento de snapshots con/bcv/banks; las capturas pueden diferir si ocurre una actualización entre llamadas. Conserva la precisión recibida y aplica el redondeo al presentar o fijar importes.