API REST · JSON

La API de tasas de Venezuela

El dólar y el euro BCV, el USDT P2P, la tasa de cada banco y su historial, con los mismos datos que usa la app Referencias VE.

Probar la API Solicitar API key

Paso 1

Pide tu API key

Cuéntanos para qué la necesitas en el formulario de abajo y te la enviamos por correo.

Paso 2

Identifícate en cada consulta

Incluye tu API key en el encabezado x-api-key. Sin ella, la API responde con el error 401.

Paso 3

Usa la dirección base

Todas las consultas parten de https://api.referenciasve.com, sin número de versión.

Playground

Pruébala con datos reales

Endpoints

Parámetros

currencysource

curl "https://api.referenciasve.com/rates/latest?currency=USD&source=BCV" \
  -H "x-api-key: TU_API_KEY"

Respuesta de ejemplo

[
  {
    "currency": "USD",
    "price": "873.86700000",
    "type": "FIAT",
    "source": "BCV",
    "change": "1.47430000",
    "changePercent": "0.17",
    "entityName": "BCV",
    "createdAt": "2026-10-06T23:00:01.537Z"
  },
  {
    "currency": "USDT",
    "price": "1001.79265000",
    "type": "CRYPTO",
    "source": "BINANCE",
    "change": "2.14160000",
    "changePercent": "0.21",
    "entityName": "Binance",
    "createdAt": "2026-10-07T15:30:00.722Z"
  }
]

El botón consulta la API real a través de referenciasve.com y muestra hasta 10 resultados. En tu integración usa tu propia API key.

Referencia

Endpoints

GET

/rates/latest

Todos los planes

Tasas actuales. La última tasa de cada moneda y fuente: dólar y euro BCV, promedio BCV, USDT P2P y monedas de la región.

Parámetro	Descripción
currency string · opcional	Filtra por moneda: USD, EUR, Promedio, USDT, COP, PEN, CLP, ARS, MXN, BRL.
source string · opcional	Filtra por fuente: BCV, BINANCE, CRIPTOYA_OKX, CRIPTOYA_BYBIT, CALCULATED.

Devuelve una fila por cada combinación de moneda y fuente, siempre la más reciente.
No incluye las tasas de los bancos: esas están en /rates/banks.

[
  {
    "currency": "USD",
    "price": "873.86700000",
    "type": "FIAT",
    "source": "BCV",
    "change": "1.47430000",
    "changePercent": "0.17",
    "entityName": "BCV",
    "createdAt": "2026-10-06T23:00:01.537Z"
  },
  {
    "currency": "USDT",
    "price": "1001.79265000",
    "type": "CRYPTO",
    "source": "BINANCE",
    "change": "2.14160000",
    "changePercent": "0.21",
    "entityName": "Binance",
    "createdAt": "2026-10-07T15:30:00.722Z"
  }
]

GET

/rates/banks

Desde Basic

Tasas de los bancos. La última tasa del dólar publicada por cada banco venezolano.

Parámetro	Descripción
currency string · opcional	Filtra por moneda. Hoy solo hay USD.

El nombre del banco viene en entityName; la fuente es EXCHANGE_MONITOR y el tipo, BANK.
Se actualiza una vez al día. Revisa createdAt: si un banco deja de publicar, su última tasa se mantiene con la fecha original.

[
  {
    "currency": "USD",
    "price": "925.94000000",
    "type": "BANK",
    "source": "EXCHANGE_MONITOR",
    "change": "42.52000000",
    "changePercent": "4.81",
    "entityName": "Banesco",
    "createdAt": "2026-10-07T08:00:11.476Z"
  },
  {
    "currency": "USD",
    "price": "901.59000000",
    "type": "BANK",
    "source": "EXCHANGE_MONITOR",
    "change": "30.10000000",
    "changePercent": "3.45",
    "entityName": "Banco Mercantil",
    "createdAt": "2026-10-07T08:00:11.442Z"
  }
]

GET

/rates/history

Desde Basic

Historial. Todos los registros de una moneda en un rango de fechas, del más reciente al más antiguo.

Parámetro	Descripción
currency string · opcional	Moneda a consultar.
source string · opcional	Fuente: BCV, BINANCE, CRIPTOYA_OKX, CRIPTOYA_BYBIT, CALCULATED, EXCHANGE_MONITOR.
period enum · opcional	Atajo de rango: 7d, 15d, 30d o 90d.
from ISO 8601 · opcional	Fecha inicial. Tiene prioridad sobre period.
to ISO 8601 · opcional	Fecha final.

Sin from ni period devuelve los últimos 12 meses; nunca va más atrás de un año.
Filtra siempre por currency y source: sin filtros trae todas las monedas y la respuesta es pesada.

[
  {
    "currency": "USD",
    "price": "873.86700000",
    "type": "FIAT",
    "source": "BCV",
    "change": "1.47430000",
    "changePercent": "0.17",
    "entityName": "BCV",
    "createdAt": "2026-10-06T23:00:01.537Z"
  },
  {
    "currency": "USD",
    "price": "872.39270000",
    "type": "FIAT",
    "source": "BCV",
    "change": "1.02380000",
    "changePercent": "0.12",
    "entityName": "BCV",
    "createdAt": "2026-10-05T23:00:02.216Z"
  }
]

GET

/rates/history/sparkline

Desde Basic

Serie para gráficos. El historial promediado en hasta 50 puntos, listo para dibujar una línea de tendencia.

Parámetro	Descripción
currency string · requerido	Moneda a graficar.
source string · requerido	Fuente: BCV, BINANCE, CRIPTOYA_OKX, CRIPTOYA_BYBIT, CALCULATED, EXCHANGE_MONITOR.
period enum · requerido	7d, 15d, 30d o 90d.

Los puntos vienen del más antiguo al más reciente y price es un número.
Responde con Cache-Control: 24 horas para BCV y monedas de la región, 8 horas para cripto.

[
  {
    "date": "2026-09-30T23:00:01.816Z",
    "price": 860.1753
  },
  {
    "date": "2026-10-01T23:00:03.687Z",
    "price": 866.5612
  }
]

Respuesta

Campos de cada tasa

Campo	Tipo	Descripción
currency	string	Código de la moneda: USD, EUR, USDT, Promedio, COP…
price	string decimal	Valor en bolívares (VES). Llega como texto con 8 decimales para no perder precisión.
type	enum	FIAT (oficial BCV), CRYPTO (P2P), TRIANGULATED (monedas de la región) o BANK.
source	string	Origen del dato: BCV, BINANCE, CRIPTOYA_OKX, CRIPTOYA_BYBIT, CALCULATED o EXCHANGE_MONITOR.
change	string decimal	Variación en bolívares frente al registro anterior.
changePercent	string decimal	Variación porcentual frente al registro anterior, con 2 decimales.
entityName	string \| null	Nombre legible: el banco en /rates/banks, la plataforma en cripto.
createdAt	ISO 8601	Momento en que se registró la tasa (UTC).

Los decimales llegan como texto: conviértelos con Number(price) o Decimal(price) según tu lenguaje.

Errores y límites

Qué puede responder la API

400

Parámetro inválido, por ejemplo un period o source que no existe. El mensaje dice cuál.

401

Falta el header x-api-key o la key no es válida.

403

Agotaste la cuota diaria (se reinicia 24 horas después de la primera petición del ciclo) o el endpoint no está en tu plan: el plan Gratis solo accede a /rates/latest.

429

Demasiadas peticiones seguidas: máximo 100 por minuto y 1.000 por hora por IP.

Cada respuesta trae los headers x-ratelimit-remaining-short (minuto) y x-ratelimit-remaining-long (hora) para que sepas cuánto te queda. Los errores llegan en JSON con message y statusCode.

Planes

Planes diseñados para crecer

Gratis

Para pruebas y proyectos pequeños

200 peticiones por día
Tasas actuales: BCV, USDT y monedas de la región
Uso comercial, citando a Referencias VE como fuente

Pedir key gratis

Basic

$5 /mes

o $50 al año

1.000 peticiones por día
Tasas de cada banco
Historial de 12 meses y serie para gráficos
Soporte por correo

Solicitar Basic

Pro

$15 /mes

o $150 al año

10.000 peticiones por día
Todo lo de Basic
Avisos automáticos a tu sistema cuando cambia una tasaPróximamente
Soporte prioritario

Solicitar Pro

Enterprise

A medida

Para fintechs y alto volumen

Sin límite de cuota diaria
Integración con tu sistema incluida
Condiciones y facturación a tu medida

Hablar con nosotros

Los precios están en dólares. El límite de 100 peticiones por minuto por IP aplica a todos los planes.

Integraciones

Nosotros hacemos la integración

Si no cuentas con un equipo técnico, Luxury Labs, el estudio detrás de Referencias VE, conecta las tasas a tu tienda en línea, tu sistema contable o tu canal de atención. Los complementos listos para instalar están en desarrollo; la integración a medida está disponible desde hoy.

Próximamente

API key

¿Listo para integrar?

Cuéntanos para qué la necesitas y te enviamos tu API key, o la cotización de tu integración, en 1 a 2 días hábiles.

¿Solo quieres ver las tasas? Están en la página principal y en la app.

La API de tasas de Venezuela

Pide tu API key

Identifícate en cada consulta

Usa la dirección base

Pruébala con datos reales

Endpoints

/rates/latest

/rates/banks

/rates/history

/rates/history/sparkline

Campos de cada tasa

Qué puede responder la API

Planes diseñados para crecer

Nosotros hacemos la integración

WooCommerce

Odoo

Shopify

Bot de WhatsApp o Telegram

Integración a medida

¿Listo para integrar?