stake-availability.mdx

title	stake-availability
description	Free vs locked stake for a coldkey on one subnet.

{/* GENERATED by scripts/generate.py from the SDK registries — do not edit. */}

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

Parameter	Type	Description
coldkey_ss58	string	Coldkey whose free/locked stake to read.
netuid	integer	Subnet 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

• Runtime API StakeInfoRuntimeApi.get_stake_availability_for_coldkeys

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