Saldos
Un saldo por moneda, con cada movimiento explicado.
GET/v1/balances
{
"data": [
{
"currency": "USDT",
"primary": true,
"available": "1250.000000",
"pending": "0.000000",
"reserved": "100.500000",
"in_settlement": "0.000000",
"earnings": "12.400000",
"total": "1350.500000",
"as_of": "2026-10-18T14:05:00Z"
}
]
}| Campo | Qué es |
|---|---|
available | Lo que puedes usar ahora: pagar, retirar, reembolsar. |
reserved | Apartado para pagos y retiros en curso. |
pending | Acreditado pero todavía no disponible. |
in_settlement | En camino a tu cuenta en una liquidación. |
earnings | Tus márgenes acumulados (tenant_markup). Se muestran aparte y no suman en total. |
total | available + pending + reserved + in_settlement. |
primary | Marca el saldo en tu moneda principal (primary_treasury_asset). |
Una moneda que nunca tuviste no aparece en la lista.
Movimientos
GET/v1/balances/{currency}/entriesCada movimiento de tu saldo, del más nuevo al más antiguo (se pagina con after):
{
"id": "ent_01m3sgb1...",
"journal_id": "jrn_01m3sgb1...",
"purpose": "payout_reserve",
"account": "available",
"direction": "debit",
"amount": "100.500000",
"currency": "USDT",
"origin": { "type": "payout", "id": "pout_01m3sgb02af7nb0jf73vwv2sd4" },
"occurred_at": "2026-10-18T14:00:20Z"
}accountdice qué parte del saldo se movió:available,pending,reserved,in_settlementoearnings.directionescreditodebit, yamountsiempre es positivo.- Dos movimientos con el mismo
journal_idson los dos lados de una misma operación: por ejemplo, un pago mueve fondos deavailableareserved. originapunta a la operación: un cobro (pin_), un pago (pout_), un reembolso (rfd_), un retiro (wdr_), una liquidación (stl_) o un ajuste (adj_).