Desarrolladores
API y desarrolladores
Tasas USDT/VES y BCV en vivo, comisiones de retiro y cotización Pago Móvil. API REST pública, sin registro y sin API key.
VEX Wallet expone una API REST pública, de solo lectura y sin autenticación con las mismas tasas y comisiones que usa la app: tasa USDT/VES (piso P2P de Binance), tasa oficial BCV, historial de tasas, comisiones de retiro y cotización de Pago Móvil. Todas las respuestas son JSON.
- Especificación OpenAPI 3.1: https://vexwallet.co/openapi.json
- Catálogo de APIs (RFC 9727): https://vexwallet.co/.well-known/api-catalog
- Resumen para LLMs: https://vexwallet.co/llms.txt
Inicio rápido
No necesitas registrarte ni una API key. Prueba la tasa USDT/VES en vivo:
curl -s "https://fx.vexwallet.co/api/v1/fx/latest?pair=USDT/VES&source=binance&method=p2p_floor"
{
"pair": "USDT/VES",
"source": "binance",
"method": "p2p_floor",
"price": 961.058,
"asOf": "2026-09-24T14:58:00.303Z",
"fetchedAt": "2026-09-24T14:58:00.303Z",
"side": "FLOOR",
"paymentMethod": null
}
Servidores
| API | URL base | Contenido |
|---|---|---|
| FX | https://fx.vexwallet.co/api/v1 |
Tasas de cambio en vivo e historial |
| Pagos (público) | https://api.vexwallet.co/api/v1 |
Comisiones de retiro y cotización Pago Móvil |
Autenticación
Los endpoints de esta página no requieren autenticación. Los endpoints de Pagos aceptan el encabezado opcional x-tenant-id (por defecto vex-wallet).
CORS está limitado a los dominios de VEX: llama a la API desde tu servidor, script o agente, no desde el navegador de terceros.
Endpoints
GET /fx/latest
Última tasa registrada para un par. Servidor: https://fx.vexwallet.co/api/v1.
| Parámetro | Tipo | Descripción |
|---|---|---|
pair |
string | Par BASE/QUOTE. Por defecto USDT/VES. |
source |
string | Fuente: binance (P2P) o bcv (oficial). |
method |
string | p2p_floor para el piso P2P de Binance (la referencia de VEX). |
side |
string | Opcional: BUY, SELL, FLOOR, OFFICIAL. |
# Tasa oficial BCV (USD/VES)
curl -s "https://fx.vexwallet.co/api/v1/fx/latest?pair=USD/VES&source=bcv"
Responde 404 si no hay tasa para el filtro y 400 si pair no tiene el formato BASE/QUOTE.
GET /fx/history
Serie histórica de tasas, cruda o agregada. Servidor: https://fx.vexwallet.co/api/v1.
| Parámetro | Tipo | Descripción |
|---|---|---|
pair |
string | Par BASE/QUOTE. Por defecto USDT/VES. |
source |
string | binance o bcv. |
side |
string | Opcional, igual que en /fx/latest. |
days |
entero | Ventana de días hacia atrás. |
startDate / endDate |
fecha ISO 8601 | Rango explícito (alternativa a days). |
interval |
hour | day | auto |
Agrupa por hora o día. Sin valor: datos crudos. |
aggregation |
avg | min | max | first | last |
Por defecto avg. |
sort |
asc | desc |
Por defecto asc. |
limit |
entero | Máximo de puntos. Por defecto 100. |
curl -s "https://fx.vexwallet.co/api/v1/fx/history?pair=USDT/VES&source=binance&days=7&interval=day"
GET /public/withdraw/fee-schedule
Política de comisiones de retiro vigente. Servidor: https://api.vexwallet.co/api/v1.
curl -s "https://api.vexwallet.co/api/v1/public/withdraw/fee-schedule"
{
"policy": "legacy_flat",
"minWithdrawalCents": 1000,
"summary": "1.5% + $3.50 + fee de red",
"serviceFeePercent": 1.5,
"serviceFeeFixedCents": 350,
"networkFeeCents": 150
}
GET /public/withdraw/estimate-fee
Estimación de la comisión para un monto, sin beneficios específicos de usuario. Servidor: https://api.vexwallet.co/api/v1.
| Parámetro | Tipo | Descripción |
|---|---|---|
amount_cents |
entero (requerido) | Monto a retirar en centavos de USD. |
method |
string | PAGO_MOVIL, CRYPTO_WALLET, ACH, PAYPAL. |
network |
string | Red blockchain (TRC20, ERC20) para CRYPTO_WALLET. |
asset |
string | USDT (por defecto) o USDC. |
curl -s "https://api.vexwallet.co/api/v1/public/withdraw/estimate-fee?amount_cents=5000&method=PAGO_MOVIL"
GET /public/withdraw/pago-movil-quote
Cotización de retiro a Pago Móvil: tasa base, tasa ofrecida y bolívares estimados. Servidor: https://api.vexwallet.co/api/v1.
| Parámetro | Tipo | Descripción |
|---|---|---|
amountCents |
entero (requerido) | Monto en centavos de USD. Mínimo 1000 ($10). |
calculator |
1 |
Usa la comisión completa de la política (sin exoneraciones). |
curl -s "https://api.vexwallet.co/api/v1/public/withdraw/pago-movil-quote?amountCents=5000&calculator=1"
{
"exchange_rate_base": 961.058,
"exchange_rate_offered": 879.87,
"exchange_rate_fetched_at": "2026-09-24T14:58:00.303Z",
"margin_percent": 0.0179,
"ves_estimate": 40914.14
}
Errores
Los errores usan códigos HTTP estándar y un cuerpo JSON:
{ "statusCode": 400, "error": "Bad Request", "message": "pago_movil_min_amount" }
| Código | Significado |
|---|---|
400 |
Parámetro inválido (pair must be like BASE/QUOTE, invalid_amount_cents, pago_movil_min_amount). |
404 |
No hay tasa para el filtro solicitado. |
503 |
Servicio de tasas no disponible temporalmente; reintenta con espera. |
Buenas prácticas
- Las tasas se actualizan cada pocos minutos: guarda en caché al menos 60 segundos.
- Las tasas y comisiones son referenciales; la tasa aplicable a cada operación se confirma en la app antes de ejecutarse.
- Usa
asOfpara saber qué tan reciente es una tasa.
API de comercios VEXPay
Para cobrar (links de pago, pago móvil C2P, tarjeta VPOS, liquidaciones y webhooks firmados) existe la API de comercios VEXPay, autenticada con una API key de tenant en el encabezado x-api-key. Hay claves de prueba y de producción. Solicita acceso en hi@vexwallet.co o conoce VEXPay y el plugin de WooCommerce.
Soporte
Escríbenos a hi@vexwallet.co o visita Contáctanos.