Importes y bolívares

Todos los montos son enteros en unidades menores. Nunca coma flotante.

5000000  =  50.000,00 Bs
  50000  =     500,00 Bs
    100  =       1,00 Bs
      1  =       0,01 Bs

Activo	Decimales	1,00	500,00	50.000,00
BS	2	100	50000	5000000
USD	2	100	50000	5000000

BS es el activo con el que dispersas. USD sólo aparece como activo del lado que gastas en una cotización con conversión.

Número en la petición, string en la respuesta

Lo que mandas

{ "deliver": { "asset": "BS", "amount": 5000000 } }

Lo que recibes

{
  "spend":   { "asset": "BS", "amount": "5050000" },
  "deliver": { "asset": "BS", "amount": "5000000" },
  "fee":     { "asset": "BS", "amount":   "50000" }
}

Dirección	Tipo JSON	Detalle
Petición	número entero	"5000000" y 5000000.5 se rechazan con 400 validation_failed
Respuesta	string	Un importe grande no cabe con seguridad en el Number de JavaScript

Parsea las respuestas con enteros de precisión arbitraria

En JavaScript, BigInt(quote.deliver.amount), no Number(...).

Convertir

const aMinor = (bs) => BigInt(Math.round(bs * 100));   // sólo desde un input humano
const aTexto = (minor) => (BigInt(minor) / 100n) + ',' + String(BigInt(minor) % 100n).padStart(2, '0');
aTexto("5000000");   // "50000,00"

Si el importe nace de un campo de texto, valídalo como decimal de dos posiciones antes de multiplicar por 100.

Las cifras de una dispersión

Cifra	En la cotización	En la respuesta de la dispersión	En el pago
Lo que recibe el beneficiario	deliver.amount	amount	payout_amount
Nuestra comisión	fee.amount	feeAmount	fee_amount
Lo que se te debita	spend.amount	totalDebited	source_amount

Sin conversión la comisión se cobra encima (spend = deliver + fee); con conversión se descuenta de lo convertido (deliver = lo convertido menos fee). Ver cotizar.

En un pago failed la comisión es 0: el asiento se revierte entero.

Las tasas son decimales

{ "value": "37.81", "market": "38", "spread_bps": 50 } — value es la tasa aplicada, con nuestro margen; market la de referencia, antes del margen; spread_bps la diferencia en puntos básicos. rate es null cuando no hay conversión.

Tu saldo

GET /treasury/position también devuelve unidades menores como strings. Qué significa cada cifra: liquidación y cierre diario.