# balances (/docs/query/balances)

**Category:** Accounts & keys

## Parameters [#parameters]

| Parameter       | Type  | Description                           |
| --------------- | ----- | ------------------------------------- |
| `coldkey_ss58s` | array | Coldkeys whose free balances to read. |

## CLI [#cli]

```bash
btcli query balances --coldkeys <array> --json
```

## Python [#python]

Namespace method (autocomplete, signature help):

```python
import bittensor as bt

sub = bt.Subtensor()
result = sub.balances.balances(coldkey_ss58s=[...])
```

Or dispatch by name, as an agent would:

```python
result = sub.read("balances", coldkey_ss58s=[...])
```

Async is the same surface awaited: `async with bt.Subtensor() as client:`.

## On-chain implementation [#on-chain-implementation]

* Storage `System.Account` — implemented by Substrate's `frame_system`, outside this repository's pallets.

Every file is browsable under [/code](/code) exactly as built into the runtime.