Balances represent how much money you have available in Treasury, organized by currency.
They are updated automatically as funds are collected, paid out, converted, or moved.
How balances work
Each currency has its own balance.
Balances change as transactions occur:
- Incoming payments increase balances
- Payouts and withdrawals decrease balances
- Refunds reduce balances
- FX conversions move value between currencies
Balances reflect the current state of your funds at any point in time.
Available balance
The available balance is the amount of funds you can use.
You can use available balance to:
- Send payouts
- Withdraw funds
- Perform FX conversions
Available balance updates as transactions are processed.
Multi-currency balances
Treasury supports multiple currencies.
- Each currency is tracked independently
- Funds must be available in the required currency to be used
- FX conversions can be used to move value between currencies
This allows you to manage funds globally while maintaining currency separation.
How balances update
Balances are updated based on transaction activity.
Examples:
- A completed payment increases your balance in that currency
- A payout decreases your balance when funds are sent
- A refund decreases your balance when funds are returned
- An FX conversion decreases one currency and increases another
All balance changes are recorded as transactions.
Relationship to transactions
Balances are derived from transactions.
- Every balance change corresponds to a transaction
- Transactions provide a detailed record of activity
- Balances provide a summarized view of current funds
Use transactions when you need detail, and balances when you need a snapshot.
Funding and availability
Before sending payouts or making transfers, ensure you have sufficient balance in the required currency.
If funds are not available:
- Add funds to Treasury
- Or convert from another currency using FX
Tracking balances
You can monitor balances in the Console.
You can also:
- Track balance changes through transactions
- Use webhooks to monitor activity
- Export data for reporting
Key behaviors
- Balances are maintained per currency
- Balances update automatically as transactions occur
- FX conversions move value between balances
- Insufficient balance will prevent payouts or transfers
Summary
- Balances show how much money you have available
- Each currency is tracked separately
- Transactions drive all balance changes
- Balances are used to fund payouts, withdrawals, and conversions
Last modified on March 29, 2026
