> For the complete documentation index, see [llms.txt](https://docs.origami.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.origami.tech/function/functions/group-balance.md).

# Group Balance

## <mark style="color:purple;">`group_balance`</mark>(*coin*: *str*, *group\_id*: *Optional*\[*int*]) -> \[[*<mark style="color:blue;">GroupBalance</mark>*](/function/structures/groupbalance.md)]

Returns structure that can be used to obtain balance of tokens saved at the moment when <mark style="color:red;">`update_balance_formula`</mark> **in group** returns <mark style="color:red;">`True`</mark> or any other non-zero value

If <mark style="color:red;">`group_id`</mark> is empty - uses current exchange for bot’s account.group\_id

<mark style="color:red;">`coin`</mark> check \[<mark style="color:red;">`balance`</mark>] specification

<details>

<summary>Example:</summary>

<mark style="color:red;">`group_balance('USDT').start.available`</mark> → 100.2

<mark style="color:red;">`group_balance('ETH').start.reserved`</mark> → 2.3056

<mark style="color:red;">`group_balance(’base’).current.available`</mark> → 300.5

<mark style="color:red;">`group_balance('counter').current.total`</mark> → 300.5

<mark style="color:red;">`group_balance('base', group_id=100).start.total`</mark> → 100.1

</details>