Saldo e extrato - SwytchPay

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

Saldo

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

{
  "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:

{
  "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.