> ## 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.

# BCV: otras divisas

> Consulta referencias BCV de EUR, CNY, TRY y RUB y su fecha valor publicada.

`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`.

<span id="request" />

## Consulta

Devuelve el último snapshot capturado, que puede anunciar una fecha valor futura. No requiere parámetros; admite [formatos](/api/formats). 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](/api/quickstart#paso-2); configura allí `COTIZAVE_API_KEY`.

<CodeGroup>
  ```bash curl theme={null}
  curl --fail-with-body --max-time 10 "https://api.cotizave.com/v1/fx/bcv/currencies" \
    -H "X-API-Key: $COTIZAVE_API_KEY"
  ```

  ```javascript Node.js theme={null}
  import { cotizave } from './cotizave.mjs';

  const data = await cotizave('/v1/fx/bcv/currencies');
  console.log(data);
  ```

  ```python Python theme={null}
  from cotizave import cotizave

  data = cotizave('/v1/fx/bcv/currencies')
  print(data)
  ```
</CodeGroup>

<span id="response" />

## Respuesta

Respuesta ilustrativa: las cifras y fechas no son cotizaciones actuales.

```json theme={null}
{
  "reference_value_date": "2026-10-20",
  "reference_value_date_text": "Martes, 20 Octubre 2026",
  "rates": {
    "EUR": 550.12,
    "CNY": 66.42,
    "TRY": 10.15,
    "RUB": 5.83
  },
  "captured_at": "2026-10-19T21:00:00Z"
}
```

`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.

<span id="casos-uso" />

## 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.

<span id="errores" />

## Errores

`404 bcv_snapshot_unavailable` indica que no hay un snapshot disponible.

Además pueden producirse los [errores comunes](/api/errors) de autenticación, cuota o disponibilidad. Las respuestas de error de la API son JSON; decide por `code`, no por el texto de `message`.

<span id="notas" />

## 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.


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