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
USDT	6	1000000	500000000	50000000000
USDC	6	1000000	500000000	50000000000

BS es el activo con el que dispersas. USD, USDT y USDC sólo aparecen como activo del lado que gastas en una cotización con conversión.

USDT y USDC llevan 6 decimales, no 2

100 en USDT o USDC son 0,0001, no 100. Para cotizar 100 USDT manda 100000000. Es el error más común al pasar de USD a un token: con 2 decimales supuestos, la cotización sale 10.000 veces más pequeña (o más grande, en sentido inverso) y parece un error de tasa.

Con 6 decimales, una entrega exacta en Bs se cotiza sin redondeo: cada micro-USDT vale menos de un céntimo de bolívar.

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, en unidades mayores (bolívares por 1 USD o 1 USDC, sin importar los decimales de cada activo); market la de referencia, antes del margen; spread_bps la diferencia en puntos básicos. rate es null cuando no hay conversión. Los valores de este ejemplo son ilustrativos, no una tarifa: la tuya está en GET /v1/fee-schedules.

Tu saldo

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