# Saldos (/docs/balances)

<Endpoint method="GET" path="/v1/balances" href="/docs/api/balances/list-balances" />

```json
{
  "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 [#movimientos]

<Endpoint method="GET" path="/v1/balances/{currency}/entries" href="/docs/api/balances/list-balance-entries" />

Cada movimiento de tu saldo, del más nuevo al más antiguo (se pagina con `after`):

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

- `account` dice qué parte del saldo se movió: `available`, `pending`, `reserved`, `in_settlement` o `earnings`.
- `direction` es `credit` o `debit`, y `amount` siempre es positivo.
- Dos movimientos con el mismo `journal_id` son los dos lados de una misma operación: por ejemplo, un pago mueve fondos de `available` a `reserved`.
- `origin` apunta a la operación: un cobro (`pin_`), un pago (`pout_`), un reembolso (`rfd_`), un retiro (`wdr_`), una liquidación (`stl_`) o un ajuste (`adj_`).