BCV Exchange Rates API

API robusta y ligera para consultar las tasas de cambio oficiales del Banco Central de Venezuela (BCV).

Endpoints Principales

1. Obtener Tasa Actual

Retorna el valor más reciente de una moneda específica.

GET /api/rates/current?currency={CÓDIGO}

Parámetros:

  • currency (requerido): Código de la moneda (USD, EUR, CNY, TRY, RUB).

Ejemplo de uso:

curl "https://api-bcv.vercel.app/api/rates/current?currency=USD"

Respuesta (200 OK):

{
  "currency": "USD",
  "value": 35.50,
  "updatedAt": "2025-12-27T18:00:00.000Z"
}

2. Consultar Histórico por Fecha y Hora

Permite obtener la tasa oficial que estaba vigente en una fecha y hora específica.

GET /api/rates/historical?currency={CÓDIGO}&date={YYYY-MM-DD}&time={HH:mm}

Parámetros:

  • currency (requerido): Código de la moneda.
  • date (requerido): Fecha en formato YYYY-MM-DD.
  • time (opcional): Hora en formato HH:mm.

Ejemplo de uso:

curl "https://api-bcv.vercel.app/api/rates/historical?currency=USD&date=2025-12-24&time=14:30"

Códigos de Moneda Soportados

USD: Dólar Estadounidense
EUR: Euro
CNY: Yuan Chino
TRY: Lira Turca
RUB: Rublo Ruso