> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swytchpay.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Saldo e extrato

<Note>**Beta** — o contrato da 1.0 em evolução, ainda não em produção. Os campos podem mudar até o lançamento.</Note>

## Saldo

`GET /v1/balance`

Uma chave por moeda que a conta operou — a sua posição cambial visível.

```json theme={null}
{
  "brl":  { "available": 125000, "pending": 0,     "blocked": 0, "total": 125000 },
  "mxn":  { "available": 48500,  "pending": 5000,  "blocked": 0, "total": 53500 },
  "usdt": { "available": 32000,  "pending": 0,     "blocked": 0, "total": 32000 }
}
```

* `available` — disponível para converter ou sacar agora.
* `pending` — a liberar (em confirmação).
* `blocked` — retido por disputa (MED).

Todos os valores são inteiros na menor unidade da respectiva moeda (centavos).

## Extrato

`GET /v1/transactions?cursor=led_xxx`

Lista o livro-razão (ledger) da sua conta — cada crédito de depósito, débito de saque, taxa e conversão,
em ordem cronológica reversa, paginado por cursor:

```json theme={null}
{
  "data": [
    { "id": "led_…", "type": "CONVERSION",  "currency": "MXN",  "amount": -480000, "ref_type": "conversion", "ref_id": "cnv_…" },
    { "id": "led_…", "type": "DEPOSIT_NET",  "currency": "MXN",  "amount": 48500,   "ref_type": "deposit",    "ref_id": "dep_…" }
  ],
  "next_cursor": null
}
```

O saldo `available` de cada moeda é sempre igual à soma dos lançamentos daquela moeda — uma invariante
conferida por conciliação diária.