# Balances

Omnibus balance views combine settled balances from the Accounting Service with transient Omnibus state for reservations and quarantined deposits.

## Balance data

| Data | Source | Meaning |
|  --- | --- | --- |
| `availableBalance` | Accounting Service | Settled virtual account balance available for withdrawal or internal transfer. |
| `reserved` | Omnibus local state | Amount held for pending withdrawals or other in-flight operations. |
| `quarantined` | Omnibus local state | Deposits detected on deposit wallets but not yet available. |
| Omnibus wallet balance | Custody account balance | On-chain balance held in the omnibus wallet. |
| Deposit wallet balance | Custody account balance | Pending or unswept funds held outside the omnibus wallet. |


The Accounting Service is the source of truth for settled virtual account balances. Omnibus local balances are operational overlays for pending states.

## Balance transitions

| Event | Available balance | Reserved | Quarantined | Host virtual account |
|  --- | --- | --- | --- | --- |
| Deposit detected on deposit wallet | No change | No change | Increases | No change |
| Deposit confirmed but below dust threshold | No change | No change | No change | No change |
| Deposit swept and recorded | Increases | No change | Decreases | No change |
| Deposit sweep fee compensation | No change | No change | No change | Decreases by fee |
| Withdrawal initiated | No change | Increases | No change | No change |
| Withdrawal confirmed | Decreases | Decreases | No change | No change |
| Native-asset withdrawal fee | No change | No change | No change | Decreases by fee |
| Withdrawal cancelled | No change | Decreases | No change | No change |
| Internal transfer | Source decreases, destination increases | No change | No change | No change |
| Direct deposit to omnibus wallet | No change | No change | No change | Increases after confirmation |


## Host virtual account

Omnibus creates the host virtual account with the omnibus structure. The host virtual account represents:

- Unassigned funds sent directly to the omnibus wallet.
- Fee compensation for deposit sweeps.
- Native-asset withdrawal fees.


Because Omnibus records host-funded fees after settlement, the host virtual account can become negative. Monitor this balance and define an operational process for topping it up or investigating fee drift. Fee compensation or reimbursement records for Gas Station-funded non-native withdrawal gas depend on the final Omnibus accounting behavior for your release.

## Planned reconciliation data

Dedicated reconciliation reports and data exports are planned for a later release. Until those are available, use the current balance fields and operation records for operational checks.

## Operation records

Omnibus relies on the Accounting Service for immutable settled operation records, virtual account statements, and exports.

Omnibus operation records preserve enough context to trace:

- The custody event or transaction that triggered a balance change.
- The virtual account credited or debited.
- The source and destination virtual accounts for internal transfers.
- The related operation for fee compensation.
- The custody account and transaction references for on-chain movement.


For broader custody data-integrity concepts, see [Data integrity and governance](/products/custody/overview/security/data-integrity-and-audit-trail).