> 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/reference/grid-language/functions/group-balance.md).

# group\_balance()

group\_balance() returns the saved and current balances of a token for a group of accounts.

Understand how the Group Balance function in Origami Tech aggregates balances across multiple accounts or assets for consolidated reporting.

## `group_balance`(*coin*: *str*, *group\_id*: *Optional*\[*int*]) -> \[*GroupBalance*]

Returns structure that can be used to obtain balance of tokens saved at the moment when `update_balance_formula` **in group** returns `True` or any other non-zero value

If `group_id` is empty - uses current exchange for bot’s account.group\_id

`coin` check \[`balance`] specification

<details>

<summary>Example:</summary>

`group_balance('USDT').start.available` → 100.2

`group_balance('ETH').start.reserved` → 2.3056

`group_balance(’base’).current.available` → 300.5

`group_balance('counter').current.total` → 300.5

`group_balance('base', group_id=100).start.total` → 100.1

</details>
