Queries

balance

Free TAO balance of a coldkey address.

View as Markdown

Category: Accounts & keys

Parameters

ParameterTypeDescription
coldkey_ss58stringColdkey whose free balance to read.

CLI

btcli query balance --coldkey <ss58|name> --json

Python

Namespace method (autocomplete, signature help):

import bittensor as bt

sub = bt.Subtensor()
result = sub.balances.balance(coldkey_ss58="5F...")

Or dispatch by name, as an agent would:

result = sub.read("balance", coldkey_ss58="5F...")

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.