Cotiza USD a VES con tu tasa del bolívar
Convierte un monto en USD a VES con la tasa del bolívar de tu cuenta (BCV o mercado), más la tasa BCV oficial y la mediana entre las fuentes BCV.
Solicita una cotización
GET /v1/quote convierte un monto en USD a VES con la tasa del bolívar de tu cuenta: la tasa BCV oficial por defecto, o la tasa de mercado si la elegiste (ver abajo). Envía usdAmount como parámetro de consulta y autentícate con la x-api-key de tu tenant.
curl "${API_URL}/v1/quote?usdAmount=25" \
--header "x-api-key: ${VEXPAY_API_KEY}"const response = await fetch(
`${process.env.API_URL}/v1/quote?usdAmount=25`,
{ headers: { 'x-api-key': process.env.VEXPAY_API_KEY } }
);
if (!response.ok) throw new Error(`API error: ${response.status}`);
const quote = await response.json();Campos de la respuesta
| Campo | Significado |
|---|---|
| rate | Tasa con la que se cobran tus pagos (Bs por $1): bcvRate en cuentas BCV, la tasa de mercado en cuentas MARKET |
| rateSource | Tu ajuste de tasa del bolívar: BCV o MARKET |
| vesAmount | usdAmount convertido con rate: lo que cobraría un pago creado ahora |
| bcvRate | Tasa BCV oficial de VEX FX (siempre BCV, como referencia) |
| medianRate | Mediana de las fuentes BCV disponibles (sources.vexFx y sources.bank cuando está configurada) |
| medianVesAmount | usdAmount convertido con medianRate |
| sources.vexFx | Tasa BCV oficial de VEX FX (igual a bcvRate) |
| sources.bank | Tasa BCV del banco cuando está configurada, o { error: "BANK_NOT_CONFIGURED" } |
| fetchedAt | Marca de tiempo ISO de cuando se obtuvo la tasa autoritativa |
{
"usdAmount": 25,
"rate": 36.5,
"rateSource": "BCV",
"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" },
"bank": { "bcvRate": 36.6, "fechavalor": "2026-07-20", "fetchedAt": "2026-07-20T15:00:00.000Z" }
}
}Elige tu tasa del bolívar: BCV o mercado
En el portal, Rates → Bolívar rate define con qué tasa se convierten tus precios en USD a bolívares: BCV (oficial, por defecto) o Mercado (Binance P2P, la misma tasa base de tus conversiones a USDT, sin el spread de conversión). Aplica a enlaces de pago, al checkout y a los cobros por API que envían usdAmount. Los cobros que envían vesAmount mantienen ese monto exacto en Bs; su usdAmount se calcula con tu tasa. Cada pago guarda rate, rateSource y el bcvRate oficial, y el comprador ve Tasa BCV o Tasa de mercado.
| Un producto de $100 | BCV | Mercado |
|---|---|---|
| Tasa (ejemplo) | Bs 876,80 por $1 | Bs 1.009,00 por $1 |
| El comprador paga | Bs 87.679,76 | Bs 100.899,90 |
| usdAmount del pago | $100.00 | $100.00 |
Cómo se calcula la mediana
- Se recopilan las tasas BCV numéricas exitosas de las fuentes disponibles.
- Una tasa → esa tasa es la mediana.
- Dos tasas → el promedio de ambas (mediana de un conjunto par).
- Si sources.bank no está disponible, medianRate es igual a bcvRate.