Tasa publicada
Compra, venta y referencia
La fila expone bid, ask y mid cuando la pizarra los publica, con USD como base y VES como moneda de cotización.
BCV · pizarra bancaria
API de tasas BCV por banco
Consulta compra, venta y referencia USD/VES por institución cuando el BCV publica su pizarra.
Cada fila mantiene su fecha efectiva y estado de frescura. Así tu aplicación puede distinguir una publicación vigente de una referencia anterior sin asumir que todas las entidades cotizan cada día.
GET
/v2/fx/ve/bank-ratesbank opcionalcurl "https://api.cotizave.com/v2/fx/ve/bank-rates?bank=0102" \
-H "X-API-Key: TU_API_KEY" \
-H "Accept: application/json"Usa bank=0102 para reducir la respuesta a una institución. Sin ese parámetro recibes la pizarra publicada disponible.
Contexto temporal
No pierdas la vigencia
Conserva effective_date, updated_at y days_behind junto a cada operación; la fecha es parte del dato, no solo un detalle visual.
Identidad separada
Código ≠ cotización
El objeto bank identifica la institución. Una lista de códigos no sustituye la pizarra ni permite inferir tasas que no fueron publicadas.
Una tasa bancaria necesita contexto
Una API de banco no equivale a acceder a los servicios privados de esa institución. Cotizave entrega una pizarra cambiaria publicada; no inicia transferencias, no consulta saldos y no opera Pago Móvil.
Para contabilidad y ERPs
Guarda los valores de compra/venta con la fecha efectiva de cada transacción. El mismo registro permite auditar qué referencia se utilizó sin reemplazar los datos históricos.
Para integraciones financieras
Filtra una institución cuando tu flujo lo requiera y valida la frescura antes de presentar la tasa. La API informa datos de referencia; no representa una oferta de ejecución.
Campos que debes usar
| Campo | Uso en tu aplicación |
|---|---|
| bank | Identidad y código de la institución publicada. |
| bid · ask · mid | Valores de compra, venta y referencia cuando existan. |
| effective_date | Día al que corresponde la publicación de esa fila. |
| updated_at · days_behind | Momento de actualización y antigüedad relativa para tu política de frescura. |
Preguntas frecuentes
¿Esta es una API privada de Banco de Venezuela?
No. Esta API entrega la pizarra de tasas USD/VES que el Banco Central de Venezuela publica por institución cuando está disponible. No proporciona acceso a cuentas, transferencias, Pago Móvil ni servicios privados de Banco de Venezuela u otra entidad.
¿Qué diferencia hay entre un código de banco y una tasa por banco?
Un código identifica a una institución dentro de un directorio. Una tasa por banco es una cotización de compra y venta asociada a una pizarra publicada. El directorio no garantiza que exista una cotización para ese banco en una fecha determinada.
¿Qué ocurre si la pizarra no está disponible?
La ruta responde 404 bank_rates_not_available cuando ese país no publica una pizarra bancaria. Para Venezuela, conserva effective_date, updated_at y days_behind al decidir si una fila cumple el umbral de frescura de tu aplicación.
¿Puedo consultar un banco específico?
Sí. Usa el parámetro bank con el código de cuatro dígitos del banco venezolano. El filtro solo limita la pizarra publicada; no convierte al banco en una fuente independiente ni garantiza una fila para todas las fechas.
Elige la referencia correcta para cada flujo
Usa la API BCV para la referencia oficial general y la pizarra por banco cuando tu proceso requiera compra, venta y la institución publicada. Mantén siempre la fecha junto al valor.