Balance
API: GET /v1/balance/realtime, GET /v1/balance/closing-day
Balance is a snapshot, not a transaction status. There is no state machine — only current amounts in centavos (BRL).
| Field | Meaning |
|---|---|
availableBalance | Funds available for new Pix Out, transfers, or withdrawals |
pendingBalance | Amount reserved by operations still in progress |
totalBalance | availableBalance + pendingBalance |
lastUpdated | Timestamp of the balance read (BRT) |
Use balance to show the player wallet in your UI. Use Pix In, Pix Out, Pix Refund, or Internal transfer statuses (or Webhooks) to track individual operations.
See also Balance errors.