> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.nexbridge.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Balances

# 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:

```text theme={null}
Available + Allocated + Dirty
```

Consumed funds are excluded from total balances.

***

# Consumed Funds

Once funds are fully consumed through completed requests, they no longer appear in:

* Available
* Allocated
* Dirty
* Total

Consumed funding remains accessible through Funding Activity history.

***

# Balance Visibility

Balances are displayed per:

* partner
* asset

Network-level balance breakdown is not exposed in V1.

***

# Precision Rules

## USTBL

Supports up to 6 decimals.

Example:

```text theme={null}
1000.123456
```

***

## USDT

Supports up to 2 decimals.

Example:

```text theme={null}
1000.12
```

***

# 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