Balances
Balances provide a current operational view of partner funds by asset. Balances help partners understand which funds are:- available
- allocated
- dirty
- already consumed through completed requests
Balance Types
Available
Funds available for future request allocation. Available balances may be used to fund:- new requests
- partially funded requests
Allocated
Funds currently allocated to active requests. Allocated balances remain linked to requests until settlement completes.Dirty
Funds received from a non-approved source. Dirty balances:- remain visible operationally
- cannot participate in settlement
- cannot be allocated to requests
Total
Total balance is calculated as:Consumed Funds
Once funds are fully consumed through completed requests, they no longer appear in:- Available
- Allocated
- Dirty
- Total
Balance Visibility
Balances are displayed per:- partner
- asset
Precision Rules
USTBL
Supports up to 6 decimals. Example:USDT
Supports up to 2 decimals. Example:Dirty Balance Handling
Dirty balances remain visible for operational transparency. Dirty funds:- cannot be allocated
- cannot settle requests
- require operational review
Relationship With Requests
Balances may change when:- funding is received
- funding becomes eligible
- funding is allocated
- requests are cancelled
- requests expire
- requests are fulfilled
Funding Activity
Detailed funding movements are available through Funding Activity. Funding Activity provides visibility into:- funding lifecycle
- linked requests
- funding status
- operational allocation
Future Scope
The following capabilities are currently out of scope for V1:- manual balance adjustments
- partner-initiated withdrawals
- treasury operations
- historical balance snapshots
- network-level balance breakdown