---
title: "API y desarrolladores | VEX Wallet"
description: "API pública de VEX Wallet: tasas USDT/VES y BCV en vivo, historial, comisiones de retiro y cotización Pago Móvil. Sin autenticación, con OpenAPI y ejemplos."
url: "https://vexwallet.co/developers"
---

# API y desarrolladores

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](https://vexwallet.co/openapi.json)
- Catálogo de APIs (RFC 9727): [https://vexwallet.co/.well-known/api-catalog](https://vexwallet.co/.well-known/api-catalog)
- Resumen para LLMs: [https://vexwallet.co/llms.txt](https://vexwallet.co/llms.txt)

## Inicio rápido

No necesitas registrarte ni una API key. Prueba la tasa USDT/VES en vivo:

```bash
curl -s "https://fx.vexwallet.co/api/v1/fx/latest?pair=USDT/VES&source=binance&method=p2p_floor"
```

```json
{
  "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`. |

```bash
# 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`. |

```bash
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`.

```bash
curl -s "https://api.vexwallet.co/api/v1/public/withdraw/fee-schedule"
```

```json
{
  "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`. |

```bash
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). |

```bash
curl -s "https://api.vexwallet.co/api/v1/public/withdraw/pago-movil-quote?amountCents=5000&calculator=1"
```

```json
{
  "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:

```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 `asOf` para 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](mailto:hi@vexwallet.co) o conoce [VEXPay](https://vexwallet.co/vexpay) y el [plugin de WooCommerce](https://vexwallet.co/vexpay/woocommerce-venezuela).

## Soporte

Escríbenos a [hi@vexwallet.co](mailto:hi@vexwallet.co) o visita [Contáctanos](https://vexwallet.co/contactanos).