Queries

balances

Free TAO balance for several coldkey addresses in one batched request.

View as Markdown

Category: Accounts & keys

Parameters

ParameterTypeDescription
coldkey_ss58sarrayColdkeys whose free balances to read.

CLI

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

Python

Namespace method (autocomplete, signature help):

import bittensor as bt

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

Or dispatch by name, as an agent would:

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

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

On-chain implementation

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

Every file is browsable under /code exactly as built into the runtime.