GET /v1/fx/bcv/currencies
Devuelve las tasas de referencia oficiales publicadas por el Banco Central de Venezuela para las divisas no-USD: euro (EUR), yuan chino (CNY), lira turca (TRY) y rublo ruso (RUB).
Todas las tasas expresan cuántos bolívares (VES) corresponden a una unidad de la divisa indicada. El USD no aparece en este endpoint porque ya está cubierto de forma implícita por las columnasbuy y sell del endpoint hermano /v1/fx/bcv/banks.
Comparte el mismo snapshot diario que /v1/fx/bcv/banks. Disponible en todos los planes (incluyendo Free).
Ruta legacy: /v1/beta/fx/bcv/currencies
Si tu aplicación usa la ruta beta, sigue funcionando hasta el 14 de julio de 2026. Las respuestas legacy llevan los headers Sunset, Deprecation: true y un Link rel="successor-version". Migra a la ruta estable cuando puedas.
Request
GET /v1/fx/bcv/currencies HTTP/1.1
Host: api.cotizave.com
X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3dEste endpoint no acepta parámetros de query. Siempre devuelve el snapshot más reciente disponible.
Ejemplo con curl
curl https://api.cotizave.com/v1/fx/bcv/currencies \
-H "X-API-Key: ctz_live_aB3cD8fG2hJ5kL9mN1pQ4rS7tU0vWxYzA6bC3d"Response
200 OK
{
"reference_value_date": "2026-05-12",
"reference_value_date_text": "Lunes, 12 Mayo 2026",
"rates": {
"EUR": 96.4521,
"CNY": 12.1834,
"TRY": 2.5107,
"RUB": 0.9823
},
"captured_at": "2026-05-09T12:15:03Z"
}Schema de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
reference_value_date | string (YYYY-MM-DD) | La "Fecha Valor" del BCV: fecha en que estas tasas toman efecto legal. Puede diferir del día de extracción (habitualmente es unos días posterior). |
reference_value_date_text | string | Etiqueta legible tal como aparece en la página del BCV (ej: Lunes, 12 Mayo 2026) |
rates | object | Mapa de código ISO 4217 → tasa en VES. Claves presentes: EUR, CNY, TRY, RUB. USD excluido intencionalmente (está implícito en /bcv/banks). |
captured_at | string (ISO 8601) | Cuándo Cotizave extrajo y persistió el snapshot |
Divisas incluidas
| Código | Divisa | Notas |
|---|---|---|
EUR | Euro | Tasa de referencia oficial BCV (VES/EUR) |
CNY | Yuan renminbi (China) | Tasa de referencia oficial BCV (VES/CNY) |
TRY | Lira turca | Tasa de referencia oficial BCV (VES/TRY) |
RUB | Rublo ruso | Tasa de referencia oficial BCV (VES/RUB) |
Casos de uso típicos
Convertir montos en EUR a VES
const res = await fetch('https://api.cotizave.com/v1/fx/bcv/currencies', {
headers: { 'X-API-Key': process.env.COTIZAVE_API_KEY! }
})
const data = await res.json()
const amountEUR = 1500
const amountVES = amountEUR * data.rates['EUR']
console.log(`${amountEUR} EUR = ${amountVES.toFixed(2)} VES (BCV, Fecha Valor: ${data.reference_value_date})`)Comparar la Fecha Valor con la fecha de captura
La reference_value_date suele ser posterior al día de captura. Esto es normal: el BCV publica tasas con efecto en días futuros.
const data = await fetchBCVCurrencies()
const capturedDate = data.captured_at.slice(0, 10) // YYYY-MM-DD de extracción
const valueDate = data.reference_value_date // YYYY-MM-DD de efecto legal
console.log(`Extraído: ${capturedDate} | Efecto legal: ${valueDate}`)
// Extraído: 2026-05-09 | Efecto legal: 2026-05-12Errores posibles
| Código | error.code | Causa |
|---|---|---|
401 | invalid_api_key | API Key inválida, faltante o revocada |
404 | bcv_snapshot_unavailable | El cron diario aún no ejecutó o la variable OPEN_ROUTER_COTIZAVE_BCV no está configurada |
429 | rate_limit_exceeded | Cuota mensual agotada |
500 | internal_error | Error inesperado del lado de Cotizave |
Notas importantes
Mismo snapshot que /bcv/banks
Ambos endpoints (banks y currencies) leen del mismo snapshot diario. El captured_at será idéntico si llamas ambos endpoints en la misma ventana del día. Los datos se dividen en dos endpoints para que puedas consumir solo lo que necesitas.
Precisión de los valores
Los valores se presentan con la precisión completa que devuelve la fuente BCV. No se redondean en el proceso de extracción. Si tu aplicación necesita mostrarlos al usuario, considera redondear a 2-4 decimales según el contexto.
reference_value_date vs captured_at
Para efectos legales y contables usa reference_value_date: es la fecha en que el BCV declara que estas tasas son vigentes. Usa captured_at únicamente para control de frescura del dato (verificar que el cron ejecutó hoy).