# root-basket-owed (/docs/query/root-basket-owed)

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 [#parameters]

| Parameter      | Type   | Description                                    |
| -------------- | ------ | ---------------------------------------------- |
| `coldkey_ss58` | string | Coldkey whose pending root dividends to value. |

## CLI [#cli]

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

## Python [#python]

Namespace method (autocomplete, signature help):

```python
import bittensor as bt

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

Or dispatch by name, as an agent would:

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

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

## On-chain implementation [#on-chain-implementation]

* Runtime API [`BetaBasketRuntimeApi.get_root_basket_owed`](/code/runtime/src/lib.rs#L2354-L2356)

Every file is browsable under [/code](/code) exactly as built into the runtime.
