> ## 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

## Saldo

`GET /v1/balance`

```json theme={null}
{
  "brl":  { "available_cents": 9650, "pending_cents": 0, "blocked_cents": 0, "total_cents": 9650 },
  "usdt": { "available_cents": 0, "pending_cents": 0, "blocked_cents": 0, "total_cents": 0 }
}
```

* `available` — disponível para saque agora.
* `pending` — a liberar (retenção D+n, quando aplicável).
* `blocked` — retido por disputa (MED).

## 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 e taxa,
em ordem cronológica reversa, paginado por cursor:

```json theme={null}
{
  "data": [
    { "id": "led_…", "type": "PAYOUT_FEE", "amount_cents": -95, "ref_type": "payout", "ref_id": "pyt_…" },
    { "id": "led_…", "type": "PAYOUT",     "amount_cents": -3000, "ref_type": "payout", "ref_id": "pyt_…" },
    { "id": "led_…", "type": "DEPOSIT_NET","amount_cents": 9650, "ref_type": "deposit", "ref_id": "dep_…" }
  ],
  "next_cursor": null
}
```

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