Cotiza USD a VES con la tasa BCV

Convierte un monto en USD a VES con la tasa BCV autoritativa y la mediana entre las fuentes BCV disponibles.

Solicita una cotización

GET /v1/quote convierte un monto en USD a VES con la tasa BCV actual. Envía usdAmount como parámetro de consulta y autentícate con la x-api-key de tu tenant.

curlbash

curl "${API_URL}/v1/quote?usdAmount=25" \
  --header "x-api-key: ${VE_BANKING_API_KEY}"

JavaScriptjavascript

const response = await fetch(
  `${process.env.API_URL}/v1/quote?usdAmount=25`,
  { headers: { 'x-api-key': process.env.VE_BANKING_API_KEY } }
);

if (!response.ok) throw new Error(`API error: ${response.status}`);
const quote = await response.json();

Campos de la respuesta

Campo	Significado
bcvRate	Tasa BCV autoritativa de VEX FX usada al crear pagos
vesAmount	usdAmount convertido con bcvRate
medianRate	Mediana de las fuentes BCV disponibles (VEX FX y R4 cuando está configurado)
medianVesAmount	usdAmount convertido con medianRate
sources	Tasas por fuente (vexFx, r4) o un error cuando una fuente no está disponible
fetchedAt	Marca de tiempo ISO de cuando se obtuvo la tasa autoritativa

Estructura de la respuestajson

{
  "usdAmount": 25,
  "bcvRate": 36.5,
  "vesAmount": 912.5,
  "medianRate": 36.55,
  "medianVesAmount": 913.75,
  "source": "bcv",
  "fetchedAt": "2026-07-20T15:00:00.000Z",
  "sources": {
    "vexFx": { "bcvRate": 36.5, "fetchedAt": "2026-07-20T15:00:00.000Z" },
    "r4": { "bcvRate": 36.6, "fechavalor": "2026-07-20", "fetchedAt": "2026-07-20T15:00:00.000Z" }
  }
}

Cómo se calcula la mediana

Se recopilan las tasas BCV numéricas exitosas de VEX FX y R4.
Una tasa → esa tasa es la mediana.
Dos tasas → el promedio de ambas (mediana de un conjunto par).
Si R4 no está disponible o no está configurado, medianRate es igual a bcvRate.