> For the complete documentation index, see [llms.txt](https://taas-docs.stokr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://taas-docs.stokr.io/asset-distribution/asset-token-balance.md).

# Asset token balance

What does asset token balance consist of?

Asset token balance provides an overview of your token pool and token location or designated purpose.

The **total balance** shows how many tokens are currently in circulation. This number is broken down into subcategories by location and purpose.

* **Issuance wallet (controlled by you)**
  * **Treasury balance** - Newly minted tokens not yet allocated to any specific purpose
  * **Reserved investments balance** - Tokens allocated to investments awaiting completion (payments, agreements, etc.)
  * **Confirmed investments balance** - Tokens allocated to completed investments, ready for distribution
* **Redemption wallet (controlled by you)**
  * **Redeemed balance:** Tokens returned by investors to redemption wallets, awaiting burning
* **Investor wallets (controlled by investors)**
  * **Distributed:** Tokens circulating in investor-owned wallets

<details>

<summary>API object example</summary>

Considering `TKN` tiker for this asset with 4 decimals:

{% code overflow="wrap" %}

```json
{
    "total": {
            "value": 600000,
            "text_value": "60",
            "ticker": "TKN",
            "decimals": 4
    },
    "treasury": {
            "value": 205500,
            "text_value": "20.55",
            "ticker": "TKN",
            "decimals": 4
    },
    "reserved_investments": {
            "value": 104500,
            "text_value": "10.45",
            "ticker": "TKN",
            "decimals": 4
    },
    "confirmed_investments": {
            "value": 30000,
            "text_value": "3",
            "ticker": "TKN",
            "decimals": 4
    },
    "distributed": {
            "value": 35200,
            "text_value": "3.52",
            "ticker": "TKN",
            "decimals": 4
    },
    "redeemed": {
            "value": 0,
            "text_value": "0",
            "ticker": "TKN",
            "decimals": 4
    }
}
```

{% endcode %}

</details>

This breakdown helps you understand not just how many tokens exist, but their current state and relationship to your tokenization workflow.

{% hint style="info" %}
When you burn tokens, they disappear from the asset balance entirely. You can see all mint/burn activity in the asset events log or asset balance log.
{% endhint %}

## Changes in token balance

Changes in asset token balance result from these activities:

{% columns %}
{% column width="50%" %}

* **Minting or burning tokens** - Affects treasury balance when adding tokens for distribution or removing excess tokens. Also affects redeemed balance when burning tokens received through redemptions.
* **Investment flow** - Token shifts between treasury balance and reserved/confirmed investment balances as investors progress through the purchase process.
* **Distribution** - Transfers tokens from confirmed investments to distributed balance when tokens reach investor wallets.
* **Redemptions** - Moves tokens from distributed to redeemed balance when investors return tokens (if redemption is enabled).
  {% endcolumn %}

{% column width="50%" valign="middle" %}

<figure><picture><source srcset="/files/cKNDVLh4h0c7a4s2CXud" media="(prefers-color-scheme: dark)"><img src="https://3684682722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwrRw6wsVcErLagZrLPnf%2Fuploads%2FWILbZQBsl43ntx3WpzPe%2FToken%20balance%20light.png?alt=media&amp;token=c7521e61-a34d-4095-bb41-e0b291250794" alt=""></picture><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

You can view all these events and changes in the token balance logs for detailed tracking.

## Special cases

Some token operations have unique effects on balance tracking that are worth understanding:

* **Wallet freezing** - Temporarily restricting token transfers (e.g., for regulatory requests) doesn't affect token balances, only transfer capability.
* **Wallet recovery** - When investors lose access and tokens are reissued to new wallets, this may cause temporary balance fluctuations during the recovery process but shouldn't affect end-of-day totals.