basket-position

A staker's beta token position in one validator's basket.

beta is the staker's beta token balance — the product-facing number: it never moves with market prices, only grows as root dividends accrue and shrinks when you claim. One beta is 10^9 raw chain units and had a par value of τ1 at fund inception, so beta_price_tao (fund NAV over outstanding beta) tracks the fund's performance from 1.0. value_tao is the realizable TAO a claim would pay right now — exactly what claim_root_with_hotkey would redeem; spot_value_tao marks the same slice at spot prices (display only). Returns None when the staker holds no beta there.

Category: Staking

Parameters

Parameter	Type	Description
`hotkey_ss58`	string	Validator whose basket the position is in.
`coldkey_ss58`	string	Staker whose position to read.

CLI

btcli query basket-position --hotkey <ss58|name> --coldkey <ss58|name> --json

Python

Namespace method (autocomplete, signature help):

import bittensor as bt

sub = bt.Subtensor()
result = sub.staking.basket_position(hotkey_ss58="5F...", coldkey_ss58="5F...")

Or dispatch by name, as an agent would:

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

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