Queries

stake-availability

Free vs locked stake for a coldkey on one subnet.

View as Markdown

locked is conviction-locked mass (plus any miner collateral reserved against the coldkey on that subnet). available is what can still be unstaked or transferred without moving lock mass. Both are denominated in the subnet's own currency (TAO on netuid 0).

Category: Staking

Parameters

ParameterTypeDescription
coldkey_ss58stringColdkey whose free/locked stake to read.
netuidintegerSubnet to query.

CLI

btcli query stake-availability --coldkey <ss58|name> --netuid <integer> --json

Python

Namespace method (autocomplete, signature help):

import bittensor as bt

sub = bt.Subtensor()
result = sub.staking.stake_availability(coldkey_ss58="5F...", netuid=1)

Or dispatch by name, as an agent would:

result = sub.read("stake_availability", coldkey_ss58="5F...", netuid=1)

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

On-chain implementation

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