Formato de datos

Las reglas que comparten todas las rutas: cómo se escriben los montos, las monedas, las fechas y las páginas de resultados.

Montos en céntimos

Todos los montos son números enteros en la unidad menor de su moneda y siempre positivos. El campo se llama amountMinor (o termina en Minor). El tipo del movimiento dice si suma o resta.

// 12,50 → 1250
const amountMinor = Math.round(12.5 * 100);

// 1250 → "12,50"
const text = (amountMinor / 100).toLocaleString("es-VE", { minimumFractionDigits: 2 });

No envíes decimales

12.5 en amountMinor responde 400. Convierte a céntimos antes de enviar y evita sumar montos como números de coma flotante.

Monedas

Cada cuenta tiene una moneda fija, escrita con su código: VES, USD, USDT, EUR, BRL o COP. Un movimiento hereda la moneda de su cuenta. Para mover dinero entre monedas distintas usa una transferencia con su tasa.

Fechas

Las fechas viajan en ISO 8601. Al enviar, incluye la zona horaria para que el movimiento caiga en el día correcto: 2026-10-18T14:30:00-04:00 es la hora de Caracas. Las respuestas vienen en UTC, como 2026-10-18T18:30:00.000Z.

Identificadores

Los ids son UUID. Al crear un recurso puedes mandar tu propio id: así tu programa lo conoce antes de recibir la respuesta. En cuentas, reenviar el mismo id devuelve la cuenta existente en vez de crear otra.

Pedir o modificar un recurso que no existe, o que es de otra persona, responde 404. Nunca verás datos de otra cuenta.

Paginación

Las listas largas, como los movimientos de una cuenta, se piden por páginas con page y limit.

Parámetros de consulta

pageinteger: Número de página, desde 1. Por defecto, 1.
limitinteger: Resultados por página. Por defecto 50, máximo 200.

La respuesta trae los resultados en data y hasMore indica si hay otra página.

Respuesta paginada

{
  "data": [
    "…"
  ],
  "total": 132,
  "page": 1,
  "limit": 50,
  "hasMore": true
}