Queries

root-basket-owed

Total TAO a coldkey would realize by claiming its root dividends now.

View as Markdown

Marks the coldkey's accrued basket entitlement across every validator it root-stakes to at current pool prices (the same slippage-aware valuation the chain uses to size redemptions). This is the "pending TAO" figure behind coldkey-wide claim_root; for a per-validator breakdown use root_basket_owed_breakdown before claim_root_with_hotkey. Per-validator amounts below the claim threshold are still included here even though a claim would skip them.

Category: Staking

Parameters

ParameterTypeDescription
coldkey_ss58stringColdkey whose pending root dividends to value.

CLI

btcli query root-basket-owed --coldkey <ss58|name> --json

Python

Namespace method (autocomplete, signature help):

import bittensor as bt

sub = bt.Subtensor()
result = sub.staking.root_basket_owed(coldkey_ss58="5F...")

Or dispatch by name, as an agent would:

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

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.