Skip to content
TAO$188.27
BTC0.002928
MCap$2.22B
Vol$86.25M

API reference / Hotkeys

One hotkey: owner, subnets, prune standing, emission

GET/api/v2/hotkeys/{hotkey}
Status
Beta
Auth
API key or OAuth access token
Scope
data:read
Rate limit
plan

A hotkey dashboard.

Full description

A hotkey dashboard: its owner coldkey, delegate take and the swaps that made it the new key; on every subnet it holds a UID on (at the latest processed block), its UID, activity and validator permit, the stake on it (alpha, and at spot in TAO and USD), its nominators, childkey take, registration block and immunity, the last epoch's emission, incentive and dividends, weight setting and consensus, its children, parents and a pending child set, its nominators' alpha APYs, and its place in the runtime's prune order (prune: when the subnet is full, the next registration replaces the UID with candidate_rank 1: owner-immortal hotkeys skipped, lowest last-epoch Emission first, ties to the older registration then the lower UID, among the UIDs past their immunity while more than MinNonImmuneUids remain, else among the immune ones; on root, the member with the lowest root stake, replaced only by a newcomer with strictly more, no immunity; equal stakes share a rank, and members tied for the lowest are none of them replaced_next, the chain's pick being unspecified); its children, parents and pending child sets on every subnet, UID or not (childkeys); the emission credited through it per UTC day and subnet, by type (an open map); and its childkey split per day and subnet (childkey_daily, in amounts actually paid: take gained as a child, take paid and dividends kept as a parent, which can be above or below the split line's own figure because the runtime rescales each hotkey's alpha and root dividend parts after the split; only on the days available so far: meta.childkey_missing_days lists the window's days not available yet, which have no rows, not zeros, and on every other day no row means no childkey activity), with window totals. Credits through the hotkey include its nominators' dividends (nominator_dividend), which grow their stake: they are not the operator's income. A spot total is null when a day in the window is unpriced (never a partial sum; totals.spot_known_tao_rao is the priced part, totals.unpriced_days says why). Swaps are complete from meta.swaps_from_height. A hotkey registered in the last few minutes may not be listed on that subnet yet. The window is from_day..to_day, both inclusive (default: the last 30 available days), clamped to the available days (from 2026-09-06); meta.from_day / meta.to_day say what was served. At most 367 days (400 RANGE_TOO_LARGE) and 3,000 hotkey-days, distinct hotkeys times days served (400 BATCH_TOO_EXPENSIVE: shorten the window or split the request). Always the head (no at). A hotkey the chain has never stored a key for is a 404 HOTKEY_NOT_FOUND; a known hotkey registered on no subnet answers 200 with subnets []. Errors are application/problem+json: INVALID_ADDRESS, HOTKEY_NOT_FOUND (404), RANGE_TOO_LARGE, INVALID_DAY, INVALID_RANGE, INVALID_NETUID, INVALID_FILTER (daily_netuid without include=daily), UNKNOWN_PARAMETER, NOT_READY (503), NOT_FINAL (503), SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503).

Beta: this route may change with one release's notice in the v2 changelog; additive changes need none (x-stability: beta).

Path parameters

hotkeypath, required· string

The hotkey: SS58, or 0x + 64 hex.

Query parameters

from_dayquery· string (date)

First UTC day of daily, YYYY-MM-DD, inclusive. Default: 29 days before to_day.

Format: date, YYYY-MM-DD
to_dayquery· string (date)

Last UTC day of daily, YYYY-MM-DD, inclusive. Default: the last available day. a closed day D (before today) is the day view: emission_30d is the 30 days ending at D, valued at D's close (meta.to_day, meta.emission_price_height), and daily ends at D; final or refused, never an earlier day (a day not available yet is a 503 NOT_READY, one whose close is not followed by an indexed block a 503 NOT_FINAL; a D before the first day of emission history a 400 INVALID_RANGE). The state members (stake, take, subnets) stay the head's, so the answer still follows the tip. While the closed-day view is not available yet, a closed day ends daily only (emission_30d the head's; meta.emission_price_height absent). Today, or omitted: the head's emission_30d.

Format: date, YYYY-MM-DD
includequery· string

subnets, daily, basket, basket_holdings, childkeys, staking_options (a comma list; repeatable). The default answer is hotkey-level only: identity (its own, else its owner's), owner, root UID, take, subnet count, stake and own stake at spot, nominator positions, the last 30 available days' emission by component and, for a fund validator, its staking figures; also the stake split (root_stake_tao_rao, subnet_stake_spot_tao_rao), take_raised_30d and staking_options (option A root_stake and option B fund, two blocks never combined). subnets adds the per-subnet detail: known, swaps, subnets, totals and the window meta (from_day .. childkey_missing_days). Slim by default: the child-key graph and option C come only with their own tokens, which add to the detail and alone change nothing (no unit): childkeys adds the top-level childkeys (children, parents and pending child set on every subnet) and each subnets[] row's parents / children (pending_children is always there); staking_options adds (with subnets) staking_options.subnets, option C: one pool row per subnet the hotkey has stake on, ranked by its 7-day APY, never averaged (root_stake and fund are always there). daily adds the same detail plus the per-day rows daily (each with its realized credits, the income figure, and its root claimable apart; total_* is a flow of every credit, never income) and childkey_daily (null with subnets alone). daily / childkey_daily are ONE row per day across the hotkey's subnets (spot sums at each subnet's day close; netuid and the alpha members null; subnets / unpriced_subnets say what the sums cover) unless daily_netuid names a subnet, and the per-subnet subnets detail is computed only for include=subnets ([] with daily alone). basket adds each item's basket, the fund it runs as GET /baskets/{hotkey}'s data at the latest available day end (null for a hotkey that runs no fund), and meta.sections.basket (that read's meta); at most 20 hotkeys with it (more is a 400 BATCH_TOO_LARGE). basket_holdings implies basket and adds each fund's holdings_by_subnet to its basket (as GET /baskets/{hotkey}?include=holdings_by_subnet: the runtime's per-subnet holdings at the fund's latest swept anchor at or before the day end, null before the first sweep that kept them); the same cap (with or without basket beside it). names adds the top-level included.names: every distinct account on the page (accounts in data at any depth, event args included) keyed by its SS58 address, each {identity: {name} | null, label: {text, source, confidence, verified, inferred, as_of} | null}; the on-chain identity and the off-chain label are kept apart, and a label is never a chain fact. A missing key means 'not looked up', null means 'none'. At most 500 accounts (included.names_truncated). Read beside the answer (one more lookup); an answer with names is cached as a head answer (names follow the head). Anything else is a 400 INVALID_INCLUDE.

daily_netuidquery· integer · 0 to 65535

With include=daily: serve daily / childkey_daily as this subnet's rows (one per day, alpha members and netuid set, subnets 1) instead of one row per day across subnets. Without include=daily a 400 INVALID_FILTER; outside 0..65535 a 400 INVALID_NETUID. Omitted: the aggregated rows.

netuidsquery· string

With include=subnets or include=daily: keep the per-subnet sections to these subnets, a comma list (or the parameter repeated) of 1..64 netuids, each 0..65535 (duplicates ignored): subnets[], childkeys[] and staking_options.subnets[] keep only their rows on those subnets, and swaps[] keeps the whole-hotkey swaps (netuid null) and the per-subnet swaps on them. A subnet the hotkey has no row on is simply absent. Every hotkey-level member, totals and the daily rows still describe the whole hotkey (use daily_netuid for one subnet's daily rows). Omitted: every subnet. More than 64 subnets or anything else is a 400 INVALID_NETUID; without include=subnets or include=daily a 400 INVALID_FILTER.

Response

data is an object with these fields. Amounts are integer strings in their base unit, and null means unknown, never zero (see Units and formats). meta.at names the block the answer was read at.

The hotkey.

hotkeyobject

The hotkey, as {ss58, hex}.

2 fields in hotkey
ss58string

The account, SS58 (prefix 42).

Format: SS58 address
hexstring

The same 32-byte account id, 0x + 64 lower-case hex (the public key).

Format: 32-byte hex: 0x and 64 hex digits
identityobject · can be null

The hotkey's on-chain identity, else its Owner coldkey's (identity_via_owner). Null when neither has one, and on an older data version's answer.

9 fields in identity
namestring · can be null

The display name. As the owner set it (UTF-8; "" when left empty); null when the stored bytes are not valid UTF-8 (decoded false).

urlstring · can be null

The website. As the owner set it (UTF-8; "" when left empty); null when the stored bytes are not valid UTF-8 (decoded false).

github_repostring · can be null

The GitHub repository. As the owner set it (UTF-8; "" when left empty); null when the stored bytes are not valid UTF-8 (decoded false).

imagestring · can be null

The identity's image: our copy of the image (fetched, checked and re-encoded by bittensor.ai), never the URL set on chain. Null when we hold no copy: image_unavailable_reason says why.

discordstring · can be null

The Discord handle. As the owner set it (UTF-8; "" when left empty); null when the stored bytes are not valid UTF-8 (decoded false).

descriptionstring · can be null

A free-text description. As the owner set it (UTF-8; "" when left empty); null when the stored bytes are not valid UTF-8 (decoded false).

additionalstring · can be null

Any additional text. As the owner set it (UTF-8; "" when left empty); null when the stored bytes are not valid UTF-8 (decoded false).

image_unavailable_reasonstring · can be null

Why image is null: none_set (no image is set on chain), not_mirrored_yet (one is set and we hold no copy of it yet), fetch_failed (our last fetch of it failed: not found, refused, unreachable, or not a usable https URL) or unsafe_content (what it points at was refused: not an allowed image type, invalid or too large). Null exactly when image is served. New values may be added; treat unknown values as unavailable.

decodedboolean

True when every stored field is valid UTF-8; false when one is not (that field is then null).

identity_via_ownerboolean · can be null

True when identity is the Owner coldkey's (the hotkey has none of its own). Null on an older data version's answer.

root_uidinteger · unit id · can be null

Its UID on root (netuid 0). Null when not registered on root, and on an older data version's answer.

subnet_countinteger · unit count · can be null

Subnets it holds a UID on, root included. Null on an older data version's answer.

stake_spot_tao_raostring · unit rao (÷1e9) · can be null

Its stake on every subnet (TotalHotkeyAlpha) valued at each subnet's spot price, root 1:1, in rao of TAO. Null on an older data version's answer.

Format: whole number, as a string · can be negative
own_stake_spot_tao_raostring · unit rao (÷1e9) · can be null

The Owner coldkey's own positions on the hotkey (self-bonded), sized as /accounts/positions, in rao of TAO at spot. Null on an older data version's answer.

Format: whole number, as a string · can be negative
nominator_positionsinteger · unit count · can be null

Coldkeys holding a share, summed over its pools (a coldkey in several pools counts in each). Null on an older data version's answer.

emission_30dobject · can be null

The last 30 closed UTC days' emission through it. Null on an older data version's answer.

11 fields in emission_30d
from_daystring (date) · can be null

First UTC day of the window, inclusive: the window's first AVAILABLE day (later than to_day - 29 when fewer days are available, days_available). Null while no day is available.

Format: date, YYYY-MM-DD
to_daystring (date) · can be null

Last UTC day, inclusive: meta.emission_last_day, the last available day. Null while none is.

Format: date, YYYY-MM-DD
days_availableinteger · unit count · can be null

The UTC days in to_day - 29 .. to_day with emission rows available (0..30). Null on an older data version's answer.

days_builtinteger · unit count · can be null · deprecated

The UTC days in to_day - 29 .. to_day with emission rows available (0..30). Null on an older data version's answer. Deprecated: use days_available; sunset 2027-02-15.

Deprecated since 2026-10-17, removed after 2027-02-15. Use days_available instead.
total_spot_tao_raostring · unit rao (÷1e9) · can be null

Realized credits only: pool_dividend + take + miner_incentive + owner_cut, in rao of TAO at each subnet's spot price now (root 1:1). The root claimable is never in it (accrued until claimed: root_claimable_spot_tao_rao), and basket flush credits are in no member. The sort=emission_30d key. On an older data version's answer: every component (pool_dividend + take + miner_incentive + other). Null when not known (a credit's subnet with no spot price now, e.g. dissolved since).

Format: whole number, as a string · can be negative
pool_dividend_spot_tao_raostring · unit rao (÷1e9) · can be null

The pool's dividends (nominator_dividend): paid to the nominators, the owner's own stake included. They grow the stakers' positions: not the operator's income. Null when not known (a credit's subnet with no spot price now, e.g. dissolved since).

Format: whole number, as a string · can be negative
take_spot_tao_raostring · unit rao (÷1e9) · can be null

The take: validator_take + root_take (validator_take alone on an older data version's answer). Null when not known (a credit's subnet with no spot price now, e.g. dissolved since).

Format: whole number, as a string · can be negative
miner_incentive_spot_tao_raostring · unit rao (÷1e9) · can be null

Miner incentive credited to the hotkey (miner_incentive). Null when not known (a credit's subnet with no spot price now, e.g. dissolved since).

Format: whole number, as a string · can be negative
owner_cut_spot_tao_raostring · unit rao (÷1e9) · can be null

The subnet owner's cut credited to this hotkey (owner_cut), part of the total. Null on an older data version's answer (where it was inside other_spot_tao_rao).

Format: whole number, as a string · can be negative
root_claimable_spot_tao_raostring · unit rao (÷1e9) · can be null

Root dividends queued for the root stakers to claim (root_claimable_queued), at spot. Accrued, not realized: never part of total_spot_tao_rao or any amount total. Null on an older data version's answer.

Format: whole number, as a string · can be negative
other_spot_tao_raostring · unit rao (÷1e9) · can be null · deprecated

Deprecated. An older data version's every other component (root claimable, root take, owner cut, basket flush credits, ...), summed into its total. Null on every current answer, which splits it: the owner cut (owner_cut_spot_tao_rao, in the total), the root take (in take_spot_tao_rao) and the root claimable (root_claimable_spot_tao_rao, never in the total). Served as before on an older data version's answer. Deprecated: use owner_cut_spot_tao_rao / root_claimable_spot_tao_rao; sunset 2027-02-15.

Format: whole number, as a string · can be negative
Deprecated since 2026-10-04, removed after 2027-02-15. Use owner_cut_spot_tao_rao / root_claimable_spot_tao_rao instead.
stakingobject · can be null

For a fund validator, the staking figures as /baskets rows serve them (APY at the reference stake, realised nominator APY, swap costs, breakeven): the top-level figures over every pool, root included; subnet_only over the subnet pools only (netuid != 0; null on an older data version's answer). Null for other hotkeys, and on an older data version's answer.

13 fields in staking
poolsinteger · unit count · can be null

The validator's staked pools blended: every pool, root included (subnets and root).

pools_refusedinteger · unit count · can be null

Pools whose per-share return was refused (a share restart, or no history).

window_daysobject

The pools' window lengths.

3 fields in window_days
mininteger · unit days · can be null

The shortest pool window, days. Null without pools.

maxinteger · unit days · can be null

The longest pool window, days. Null without pools.

targetinteger · unit days

Always 7: 7 complete UTC days, fewer for a younger pool (or a short series), 1 with a material childkey take (> 1 %).

reference_stake_tao_raostring · unit rao (÷1e9) · can be null

The day's reference stake, rao (the 30-day median real stake-add; 10 TAO fallback): what the reference figures and the costs are for. Null before the first reference day.

Format: decimal number, as a string · can be negative
nominator_apy_ratiostring · unit ratio · 8 decimals · can be null

Σ w ((1 + y)^(365 / days) - 1) / Σ w: y = the pool's per-share return (TotalHotkeyAlpha / shares) over its window, net of the validator's take, alpha-denominated (the price move is not included); w = the pool's TAO value at its window open. The ROOT pool's y is its accrued root claimable over meta.root_yield_window against its root stake at the window open (pool-wide, net of take, at spot, before a claim's swap cost and RootClaimableThreshold): accrued, not realised. A rate, never a stake or income total. A signed ratio, 8 decimals. Null when a pool is refused (or none).

Format: decimal number, as a string · can be negative
apy_at_reference_stake_ratiostring · unit ratio · 8 decimals · can be null

The same on y x M: the APY a new stake of reference_stake_tao_rao would earn, with M the dilution of the reference stake X joining the pool (root: A / (A + X); a subnet: T/(T+X) x (s+X+K)/(s+K) x (A+R)/(A+X+R)). A constant-dividend model, the dividend held constant when X joins, so it understates under Yuma, where the dividend grows with stake. 8 decimals. Null with unavailable_reason (refused, no reference stake, an unpriced pool).

Format: decimal number, as a string · can be negative
reference_apr_ratiostring · unit ratio · 8 decimals · can be null

Σ w (y M x 365 / days) / Σ w: the simple (uncompounded) APR at the reference stake, breakeven_days' rate. 8 decimals. Null as apy_at_reference_stake_ratio.

Format: decimal number, as a string · can be negative
round_trip_cost_ratiostring · unit ratio · 8 decimals · can be null

1 - TAO back / the reference TAO, blended over the pools: the runtime's swap simulation at the day-end block (buy, then sell the alpha back against the same pool state); root 0. 8 decimals. Null while a pool's simulation is pending, or without a reference stake.

Format: decimal number, as a string · can be negative
entry_cost_ratiostring · unit ratio · 8 decimals · can be null

1 - alpha out x spot / the reference TAO, blended; root 0. 8 decimals. Null as round_trip_cost_ratio.

Format: decimal number, as a string · can be negative
exit_cost_ratiostring · unit ratio · 8 decimals · can be null

1 - TAO back / (alpha out x spot), blended; root 0. 8 decimals. Null as round_trip_cost_ratio.

Format: decimal number, as a string · can be negative
breakeven_daysstring · unit days · 2 decimals · can be null

round_trip_cost_ratio / (reference_apr_ratio / 365): the days the reference stake must stay to earn back its round trip, dividing exactly the cost served beside it by the APR served beside it (2 decimals). Null when either is, or when the served APR is not above 0 (unavailable_reason no_yield).

Format: decimal number, as a string · can be negative
unavailable_reasonstring · can be null

Why figures are null (precedence in this order): no_pools (no staked pool), pool_refused (a pool's return was refused: every APY and APR null), parent_set_unknown (a staked pool carries material childkey take, so its yield is rated over 1 day only until its per-day parent sets are stored) and window_too_short (a staked pool's yield window is shorter than its full window, 7 days or root's 30: a younger pool), either nulling every APY, the APR and the breakeven while the costs stay when known (parent_set_unknown is served when both hold), no_reference_stake (the reference figures and the costs null), pool_unpriced (a pool has no spot price: the reference APY, APR and breakeven null; nominator_apy_ratio stands), not_ready (the day's stake weights are not available yet: as pool_unpriced), swap_cost_pending (a pool's swap simulation has not run: the costs and breakeven null) or no_yield (the served reference_apr_ratio is not above 0, so only breakeven_days is null; the APYs, the APR and the costs are given). Null when every figure is given. New values may be added; treat unknown values as unavailable.

subnet_onlyobject · can be null

The same figures over the subnet pools only (netuid != 0; root apart): root's low yield and zero swap cost no longer dilute them. The top-level figures stay the blend over every pool, root included. Null on an older data version's answer.

8 fields in subnet_only
poolsinteger · unit count · can be null

The subnet pools blended (netuid != 0): the top-level pools without root, so never more than it.

nominator_apy_ratiostring · unit ratio · 8 decimals · can be null

As the top-level nominator_apy_ratio (Σ w ((1 + y)^(365 / days) - 1) / Σ w, the per-share return net of take, alpha-denominated), over the subnet pools only. A rate, never a total. 8 decimals. Null with unavailable_reason (no_pools, pool_refused).

Format: decimal number, as a string · can be negative
apy_at_reference_stake_ratiostring · unit ratio · 8 decimals · can be null

As the top-level apy_at_reference_stake_ratio (the constant-dividend model: the dividend held constant when the reference stake joins, so it understates under Yuma), over the subnet pools only, at the top-level reference_stake_tao_rao. 8 decimals. Null with unavailable_reason.

Format: decimal number, as a string · can be negative
round_trip_cost_ratiostring · unit ratio · 8 decimals · can be null

1 - TAO back / the reference TAO, blended over the subnet pools only (the runtime's swap simulation at the day-end block). Per pool 1 - round trip = (1 - entry) x (1 - exit), so it is entry + exit less their product, never more than entry + exit. 8 decimals. Null while a pool's simulation is pending, or without a reference stake.

Format: decimal number, as a string · can be negative
entry_cost_ratiostring · unit ratio · 8 decimals · can be null

1 - alpha out x spot / the reference TAO, blended over the subnet pools only. 8 decimals. Null as round_trip_cost_ratio.

Format: decimal number, as a string · can be negative
exit_cost_ratiostring · unit ratio · 8 decimals · can be null

1 - TAO back / (alpha out x spot), blended over the subnet pools only. 8 decimals. Null as round_trip_cost_ratio.

Format: decimal number, as a string · can be negative
breakeven_daysstring · unit days · 2 decimals · can be null

This block's round_trip_cost_ratio / (the subnet pools' reference APR / 365): the days the reference stake must stay in the subnet pools to earn back its round trip (2 decimals). The subnet APR itself is not served. Null when the round trip is, with unavailable_reason, or when that APR is not above 0 (no_yield).

Format: decimal number, as a string · can be negative
unavailable_reasonstring · can be null

Why this block's figures are null, as the top-level unavailable_reason over the subnet pools only: no_pools / pool_refused / parent_set_unknown / window_too_short (both APYs and the breakeven null; the costs stay when known), no_reference_stake (the reference APY, the costs and the breakeven), pool_unpriced / not_ready (the reference APY and the breakeven), swap_cost_pending (the costs and the breakeven), no_yield (the subnet pools' reference APR is not above 0: only the breakeven). Null when the APYs and the costs are given. New values may be added; treat unknown values as unavailable.

knownboolean

Whether the chain has ever stored a key for this hotkey (any storage item, at any time). False = never seen: subnets and every other list are [] (GET /hotkeys/{hotkey} answers such a hotkey with a 404 HOTKEY_NOT_FOUND; the list and batch forms keep its item). True with subnets [] = a known hotkey registered nowhere at meta.at.

owner_coldkeystring · can be null

The coldkey that owns the hotkey (SubtensorModule.Owner), SS58. Null without an Owner entry.

Format: SS58 address
take_ratiostring · unit ratio · 6 decimals · can be null

The effective delegate take as a ratio 0..1, 6 decimals: the share of its nominators' dividends the hotkey keeps: its Delegates entry (u16 / 65535), else the runtime's default take (take_is_default true). Never null for a missing Delegates entry on an answer carrying take_is_default; on an older answer null without a Delegates entry (never 0 %).

Format: decimal number, as a string
take_is_defaultboolean · can be null

true when the hotkey has no Delegates entry, so take_ratio is the runtime's default take (Delegates' storage default under the head's runtime: DefaultDelegateTake, 0.179995). Null on an answer from before the data source served it.

nominator_walletsinteger · unit count · can be null

Distinct coldkeys holding a non-zero share (Alpha / AlphaV2) in any of its pools, each counted ONCE however many subnets it stakes on (nominator_positions counts per pool). For a validator candidate the directory's count (GET /validators' meta.nominator_wallets_at, refreshed about every 10 minutes), else counted at meta.at. Null on an older answer.

nominator_positions_valuedinteger · unit count · can be null

Nominator positions WORTH AT LEAST 1 RAO at spot (floor(alpha x spot) >= 1; root 1:1), module and escrow (modl...) accounts excluded: the count a staker-facing page shows (nominator_positions is the exact count, dust and module accounts included). Null when not counted yet (a large hotkey is counted on a schedule), and on an older data version's answer.

nominator_wallets_valuedinteger · unit count · can be null

Distinct coldkeys among nominator_positions_valued's positions (nominator_wallets is the exact count). Null exactly when nominator_positions_valued is.

first_seen_heightinteger · unit block · can be null

The block the hotkey's Owner key was first written (its creation: its first registration or association), as far back as the storage index reaches. Null when it has no Owner entry, and on an older answer.

last_seen_heightinteger · unit block · can be null

The newest of LastUpdate (its last weights) and the registration block over its uids now (a slot never updated keeps its previous holder's LastUpdate, so the registration bounds it). Null when it holds no uid, when that block is above meta.at (a stalled chain-state dataset), and on an older answer.

root_stake_tao_raostring · unit rao (÷1e9) · can be null

Its root stake now, TotalHotkeyAlpha(hotkey, 0) (root is 1:1), rao of TAO. Null on an older data version's answer.

Format: whole number, as a string · on chain: u64
subnet_stake_spot_tao_raostring · unit rao (÷1e9) · can be null

Its stake on the subnets (netuid >= 1) valued at each subnet's spot price, rao of TAO; stake_spot_tao_rao = root_stake_tao_rao + this (checked). Null when any staked pool is unpriced (never a partial sum), and on an older answer.

Format: whole number, as a string · on chain: u64
take_raised_30dboolean · can be null

The Delegates take now is above its value 216,000 blocks (30 days) back. A chain fact, never a judgement. Null on an older answer.

staking_optionsobject · can be null

Option A (root_stake) and option B (fund, the full block) as two separate blocks, never combined (no rate across options), each with its own as_of_day / as_of_height (stored once per accrual day). Served beside the legacy staking, which a later version removes. Null on an older answer.

3 fields in staking_options
root_stakeobject

Option A: root stake to this validator.

21 fields in root_stake
optionstring

Always root_stake.

basisstring

The rate basis: the accrued claimable, holder-true. Known values: root_claimable_holder. New values may be added; show an unknown value as is (or generically).

has_root_uidboolean

The hotkey holds a root UID at as_of_height.

root_stake_tao_raostring · unit rao (÷1e9)

TotalHotkeyAlpha(hotkey, 0) at as_of_height (root is 1:1), rao of TAO: the pool the accrual dilutes over. 0 when none.

Format: whole number, as a string · on chain: u64
take_ratiostring · unit ratio · 6 decimals · can be null

The Delegates take at the head, 0..1 (6 decimals). Null without a Delegates entry.

Format: decimal number, as a string
apy_7dobject

Holder-true accrual (APY): the fund units a TAO of root stake held through the window accrued, each day at that day's own realizable NAV per unit (the value at accrual), annualised; net of take, before the claim, the escrow share excluded. A rate, never an amount, and accrued: unrealised until claimed. NAV moves after the mint are hold_return_*, never here.

apy_30dobject

The same over 30 days.

accrual_period_return_7dstring · unit ratio · 12 decimals · can be null

The 7-day window's period return y behind apy_7d: the daily holder-true accrual summed over the window, 12 decimals (apy_7d = (1 + y)^(365/7) - 1, checked within its rounding). Exact where the 8-decimal APY rounds: compose an accrual at an amount from this, never from the APY. A rate, never an amount, and accrued. Null exactly when apy_7d is (checked), and on an answer from before it.

Format: decimal number, as a string · can be negative
accrual_period_return_30dstring · unit ratio · 12 decimals · can be null

The same over the 30-day window (apy_30d = (1 + y)^(365/30) - 1). Null exactly when apy_30d is.

Format: decimal number, as a string · can be negative
realised_apy_7dobject

The root claims executed on the hotkey in the window (BasketClaimed.tao) over the mean root stake held, annualised: the realised cross-check, lumpy.

realised_apy_30dobject

The same over 30 days.

staker_twr_7dobject

BasketTwr over the window (claim and restake, each dividend at realizable value), a period return.

staker_twr_30dobject

The same over 30 days.

hold_return_7dobject

Hold without claiming: the units accrued in the window marked at realizable NAV per unit at its end against their value at accrual, a period return. Served beside apy_7d, never added to it.

hold_return_30dobject

The same over 30 days.

sell_gate_7dobject

The root-sell gate over the 7-day window.

sell_gate_30dobject

The root-sell gate over the 30-day window.

risk_principalobject

The principal's risk: low.

risk_accrualobject

The accrual's risk: medium (it sits in the fund's units).

as_of_daystring (date) · can be null

The to_day of the block's figures: the last available UTC day. Null while none is available.

Format: date, YYYY-MM-DD
as_of_heightinteger · unit block

The block the head values (stake, take, root UID) are read at, at or below meta.at.

fundobject · can be null

Option B: its fund units, the full block. Null when it runs no fund.

21 fields in fund
optionstring

Always fund_units.

statestring

dissolved (worth exactly 0); no_state (no units outstanding, nothing held); off_root (units outstanding, no root UID: holders can still claim); active (units and a root UID). Checked against has_root_uid. New values may be added; show an unknown value as is (or generically).

has_root_uidboolean

The hotkey holds a root UID at as_of_height.

nav_realizable_tao_raostring · unit rao (÷1e9) · can be null

The fund's realizable NAV (its holdings as sold through each pool), rao of TAO. Null with nav_unavailable_reason (a dissolved fund's is null with fund_dissolved, checked), and on no_state.

Format: whole number, as a string · on chain: u64
nav_spot_tao_raostring · unit rao (÷1e9) · can be null

Its spot NAV (display), rao of TAO. Null together with the realizable NAV.

Format: whole number, as a string · on chain: u64
nav_unavailable_reasonstring · can be null

Why the NAVs are null (fund_dissolved: the fund is dissolved); null when they are given. Known values: no_nav_row, unpriced_holding, fund_dissolved. New values may be added; treat unknown values as unavailable.

units_outstandingstring · unit count · can be null

BasketShares: the fund's units outstanding (units, not TAO). Null on no_state.

Format: whole number, as a string
sum_owed_unitsstring · unit count · can be null

The units its holders are owed, summed (units).

Format: whole number, as a string
unowed_unitsstring · unit count · can be null

Units outstanding no holder is owed (units); a negative one is served as stated (a data-source defect, reported).

Format: whole number, as a string · can be negative
unit_value_realizable_raostring · unit rao_per_share · can be null

The realizable NAV per unit (rao of TAO per unit, 12 decimals). Null without a NAV or units.

Format: decimal number, as a string
unit_value_spot_raostring · unit rao_per_share · can be null

The spot NAV per unit (rao of TAO per unit). Null with the realizable one.

Format: decimal number, as a string
holder_return_7dobject

Option B's headline: the realizable NAV per unit over the window's day ends, minus 1, a period return (not annualised; flow-invariant, TAO terms).

holder_return_30dobject

The same over 30 days.

n_stakersinteger · unit count · can be null

The fund's stakers at its latest available day end (the fund row's n_stakers): the (fund hotkey, coldkey) pairs holding a root share key (Alpha / AlphaV2 on netuid 0) OR a BasketClaimed record, the fund escrow excluded; it includes stakers whose root stake is now 0 with a claim record, and dust is not excluded. The stakers with root stake > 0 are the fund row's n_stakers_with_stake (GET /baskets/{hotkey}).

first_blockinteger · unit block · can be null

The fund's first block. Null on no_state.

riskobject

The units' risk: high.

as_of_daystring (date) · can be null

The fund's latest available UTC day (the figures' to_day).

Format: date, YYYY-MM-DD
as_of_heightinteger · unit block

The block the head values are read at.

displayvalue · optional

The display figures. Absent on a block that carries none.

compositionvalue · optional

The holdings' concentration at the fund's newest swept anchor at or before the day close. Absent where it is not served (directory rows, an older answer).

tradingvalue · optional

The trading status, 7-day swaps and the 30-day turnover. Absent where it is not served (directory rows, an older answer).

subnetsarray of objects · optional

Only with include=staking_options beside include=subnets (absent otherwise, and on an older data version's answer): option C, one row per pool the hotkey has stake in on a subnet (netuid >= 1), by apy_7d.value descending (nulls last), then the pool at spot (checked). A ranked list of separate pools: never average their rates.

24 fields in subnets (each item)
optionstring

Always subnet_stake.

netuidinteger · unit id

The subnet slot (>= 1; root is option A).

generationinteger · unit id · can be null

Opaque life id (the life's registration identifier), NOT a block height; use life_start_height for the first block. The subnet's current life.

life_start_heightinteger · unit block · can be null

The first block of the life generation names (GET /subnets/generations' start_height): use it, never generation, for heights, ages and dates. Null exactly when generation is null (root without a life, no subnet), or transiently when this API cannot read the lives. Root's generation 0 starts at 0.

is_current_lifeboolean · can be null

Whether generation is the slot's current life (true) or an ended one, re-registered since (false). Null exactly when generation is null, or transiently when this API cannot read the lives. Root's generation 0 is current.

uidinteger · unit id · can be null

The hotkey's UID on the subnet. Null when it is not registered there.

validator_permitboolean

A validator permit on the subnet now.

consistently_activeboolean · can be null

Active at every day end of the 7-day window. Null with no covered day.

take_ratiostring · unit ratio · 6 decimals · can be null

The hotkey's Delegates take at the head, 0..1 (6 decimals).

Format: decimal number, as a string
childkey_take_ratiostring · unit ratio · 6 decimals · can be null

The effective childkey take on this subnet, max(stored, floor), 0..1 (6 decimals).

Format: decimal number, as a string
pool_alpha_raostring · unit alpha_rao (÷1e9) · can be null

TotalHotkeyAlpha(hotkey, netuid) at the head, alpha rao.

Format: whole number, as a string · on chain: u64
pool_spot_tao_raostring · unit rao (÷1e9) · can be null

The pool at the subnet's spot price, rao of TAO, floored. Null when unpriced.

Format: whole number, as a string · on chain: u64
staker_countinteger · unit count

Coldkeys with a non-zero share in this pool at as_of_day.

tao_reserve_raostring · unit rao (÷1e9) · can be null

SubnetTAO at the head: the subnet pool's TAO depth, rao. Null when not alive.

Format: whole number, as a string · on chain: u64
alpha_reserve_raostring · unit alpha_rao (÷1e9) · can be null

SubnetAlphaIn at the head: the subnet pool's alpha depth, alpha rao, what fv_level is computed from. Null when not alive, and on an answer from before it.

Format: whole number, as a string · on chain: u64
fv_levelstring · can be null

Computed by this API from the row's two reserves (no other read): the pool's fair-value level (valuation standard 2026-09-23): L1 when a reference sale of 10 alpha moves the price by less than 1 % and the alpha reserve holds at least 1,000 alpha; L2 when it holds at least 1 alpha; else L3 (less than 1 alpha, an alpha reserve of 0 or a TAO reserve of 0 included: a thin pool, thin_pool in risk.flags). A pool property. Null without both reserves. New values may be added; show an unknown value as is (or generically).

apy_7dobject

The pool's per-share growth over 7 whole days to as_of_day, compounded (APY): alpha terms, net of take, no price term; the list's order key. Reasons: not_ready, insufficient_history, no_pool, no_permit, pool_not_alive, pool_refused (checked).

apy_30dobject

The same over 30 whole days.

tao_apr_7dobject

TAO terms, simple, with the alpha price's move: ((1 + y) x spot at the end / spot at the open - 1) x 365 / 7. apy_7d's reasons, plus price_unknown.

alpha_price_change_7dobject

The alpha spot's change over the same 7 days (a period change): the price risk on its own.

riskobject

Option C's risk: high; flags take_raised_30d, subtoken_disabled and thin_pool (added by this API exactly when fv_level is L3); window flags no_permit_in_window (checked).

as_of_daystring (date) · can be null

The rates' to_day: the share index's newest closed day.

Format: date, YYYY-MM-DD
as_of_heightinteger · unit block · can be null

The block the pool's head values are read at.

conviction_alpha_raostring · unit alpha_rao (÷1e9) · can be null

The hotkey's conviction on the subnet (HotkeyLock + DecayingHotkeyLock rolled to the head, plus the owner's buckets on the owner hotkey), floored, alpha rao: what counts toward an ownership takeover (state.ownership_takeover on the subnet). A measure of commitment, never an amount held. Null when the hotkey holds no lock there, and on an older data version's answer.

Format: whole number, as a string · on chain: u64
swapsarray of objects · optional

Detail (include=subnets / daily); absent otherwise. Hotkey swaps that made this hotkey the new key, oldest first ([] when none recorded). Read from decoded events, which are contiguous only from meta.swaps_from_height: a swap below it may be missing.

3 fields in swaps (each item)
heightinteger · unit block

Block of the swap event.

old_hotkeystring · can be null

The hotkey swapped out (the previous key), SS58 (prefix 42).

Format: SS58 address
netuidinteger · unit id · can be null

The subnet a per-subnet swap applied to; null for a whole-hotkey swap (on every subnet).

subnetsarray of objects · optional

Detail (include=subnets / daily); absent otherwise. Every subnet the hotkey holds a UID on at meta.at, root included, by netuid ([] when none). A registration in the last few minutes (after the chain-state dataset's head) is not listed yet.

22 fields in subnets (each item)
netuidinteger · unit id

The subnet slot (0 = root).

uidinteger · unit id

The hotkey's UID on the subnet.

activeboolean · can be null

Active[uid]: whether the UID counted as active in the last epoch.

validator_permitboolean · can be null

ValidatorPermit[uid].

stake_alpha_raostring · unit alpha_rao (÷1e9) · can be null

TotalHotkeyAlpha(hotkey, netuid): all alpha staked to the hotkey on the subnet (the owner's and every nominator's), in alpha rao; 0 without stake.

Format: whole number, as a string · on chain: u64
stake_spot_tao_raostring · unit rao (÷1e9) · can be null

floor(stake_alpha_rao x the subnet's spot price at meta.at), in rao of TAO (1:1 on root): a spot valuation, not an exit value. Null without a pool price.

Format: whole number, as a string · on chain: u64
stake_spot_usdstring · unit usd · 6 decimals · can be null

stake_spot_tao_rao in USD at meta.tao_usd (6 decimals). Null without either price.

Format: decimal number, as a string
nominatorsinteger · unit count · can be null

Stake positions (coldkeys holding shares) on the hotkey on this subnet, the owner's own included.

childkey_take_ratiostring · unit ratio · 6 decimals · can be null

ChildkeyTake on this subnet / 65535, a ratio with 6 decimals. Null without an entry (a take of 0).

Format: decimal number, as a string
registered_at_heightinteger · unit block · can be null

BlockAtRegistration[uid]: the block the UID was registered at.

immuneboolean · can be null

Whether the UID is still inside the subnet's ImmunityPeriod since registration at meta.at.

immunity_left_blocksinteger · unit blocks · can be null

Blocks of immunity left at meta.at (0 once past ImmunityPeriod).

emission_epoch_alpha_raostring · unit alpha_rao (÷1e9) · can be null

Emission[uid]: the alpha the last epoch paid the UID, in alpha rao. The prune order ranks by it.

Format: whole number, as a string · on chain: u64
incentive_ratiostring · unit ratio · 6 decimals · can be null

Incentive[uid] / 65535 (the miner share), 6 decimals.

Format: decimal number, as a string
dividends_ratiostring · unit ratio · 6 decimals · can be null

Dividends[uid] / 65535 (the validator share), 6 decimals.

Format: decimal number, as a string
weightsobject

Weight setting and consensus of the UID.

4 fields in weights
last_update_heightinteger · unit block · can be null

LastUpdate[uid]: the block the UID last set weights. Null without an entry.

blocks_since_updateinteger · unit blocks · can be null

meta.at height - last_update_height. Null with it.

validator_trust_ratiostring · unit ratio · 6 decimals · can be null

ValidatorTrust[uid] / 65535, a ratio with 6 decimals.

Format: decimal number, as a string
consensus_ratiostring · unit ratio · 6 decimals · can be null

Consensus[uid] / 65535, a ratio with 6 decimals.

Format: decimal number, as a string
childrenarray of objects · optional

Only with include=childkeys (absent otherwise, since 2026-10-09: payload size). ChildKeys on this subnet: the hotkeys this one delegates stake weight to ([] when none). The same as the item's childkeys[] entry for this subnet, which also covers subnets without a UID.

2 fields in children (each item)
hotkeystring · can be null

The other hotkey, SS58 (prefix 42).

Format: SS58 address
proportion_ratiostring · unit ratio · 8 decimals · can be null

The proportion (u64 / u64::MAX) as a ratio 0..1, 8 decimals (1.00000000 = all of the parent's).

Pattern: ^[01]\.[0-9]{8}$
parentsarray of objects · optional

Only with include=childkeys (absent otherwise, since 2026-10-09: payload size). ParentKeys on this subnet: the hotkeys delegating stake weight to this one ([] when none). The same as the item's childkeys[] entry for this subnet.

2 fields in parents (each item)
hotkeystring · can be null

The other hotkey, SS58 (prefix 42).

Format: SS58 address
proportion_ratiostring · unit ratio · 8 decimals · can be null

The proportion (u64 / u64::MAX) as a ratio 0..1, 8 decimals (1.00000000 = all of the parent's).

Pattern: ^[01]\.[0-9]{8}$
pending_childrenobject · can be null

PendingChildKeys on this subnet: a scheduled new child set and when it applies. Null when none. A set scheduled on a subnet the hotkey holds no UID on is in the item's childkeys[].

2 fields in pending_children
cooldown_blockinteger · unit block · can be null

The block at which the scheduled set takes effect (its cooldown ends).

childrenarray of objects

The scheduled children, in the chain's order.

stake_weightobject · can be null

The stake weight the subnet's latest epoch used for this UID (as the metagraph's stake_weight_alpha / stake_weight_share): alpha-equivalent stake (alpha + tao_weight x TAO, both inherited through childkeys), filtered only by the global StakeThreshold, not the permit filter. Null when the UID is not in that epoch's vector (registered after it) or the subnet has no epoch in coverage (root), which is distinct from a weight of 0.

4 fields in stake_weight
stake_weight_alphastring · unit alpha

The stake weight the subnet's latest epoch (epoch_height) used for this UID, exactly as the runtime logged it ('Filtered stake' / 1e9), a decimal string of alpha: alpha-equivalent stake = alpha stake + tao_weight x TAO (root) stake, both inherited through childkeys (the share a parent delegates counts at the child, not at the parent). It is filtered only by the global StakeThreshold: UIDs below it are set to 0 (at current runtimes the subnet owner's UID is exempt and keeps its weight). It is not the validator-permit filter: permits go to the top-K UIDs of this vector, so a UID with a positive weight can hold no permit. Never null here: when the UID is not in that epoch's vector (registered after it), or the subnet has no epoch in coverage, the whole stake_weight is null instead, which is distinct from a weight of 0.

Format: decimal number, as a string
stake_weight_sharestring · unit ratio

stake_weight_alpha normalised to sum 1 over the subnet's UIDs ('Normalised Stake'): the stake weight Yuma consensus used in that epoch, a ratio 0..1 as a decimal string. Never null inside a non-null stake_weight.

Format: decimal number, as a string
uidinteger · unit id

The UID the epoch weighed (the hotkey's UID on this subnet).

epoch_heightinteger · unit block

The block of the subnet's latest epoch in coverage.

nominator_yieldobject

The pool's nominator APYs in alpha.

3 fields in nominator_yield
apy_1d_ratiostring · unit ratio · 6 decimals · can be null

Nominator yield in ALPHA of this hotkey's pool over the 1 UTC day ending at its latest available day, annualised: (i_t / i_(t-1))^(365) - 1, i the pool's value per share (TotalHotkeyAlpha / TotalHotkeyShares) at a UTC day end. Net of the validator's take; alpha price moves are not in it (not a TAO or USD return). Signed, 6 decimals. Null until the daily history reaches back that far, across a share-format switch, and when the value per share is not positive.

Format: decimal number, as a string · can be negative
apy_7d_ratiostring · unit ratio · 6 decimals · can be null

Nominator yield in ALPHA of this hotkey's pool over the 7 UTC days ending at its latest available day, annualised: (i_t / i_(t-7))^(365/7) - 1, i the pool's value per share (TotalHotkeyAlpha / TotalHotkeyShares) at a UTC day end. Net of the validator's take; alpha price moves are not in it (not a TAO or USD return). Signed, 6 decimals. Null until the daily history reaches back that far, across a share-format switch, and when the value per share is not positive.

Format: decimal number, as a string · can be negative
apy_30d_ratiostring · unit ratio · 6 decimals · can be null

Nominator yield in ALPHA of this hotkey's pool over the 30 UTC days ending at its latest available day, annualised: (i_t / i_(t-30))^(365/30) - 1, i the pool's value per share (TotalHotkeyAlpha / TotalHotkeyShares) at a UTC day end. Net of the validator's take; alpha price moves are not in it (not a TAO or USD return). Signed, 6 decimals. Null until the daily history reaches back that far, across a share-format switch, and when the value per share is not positive.

Format: decimal number, as a string · can be negative
pruneobject

The UID's place in the runtime's prune order (whom the next registration replaces): by last-epoch Emission on a subnet, by root stake on root (netuid 0, basis root_stake).

7 fields in prune
subnet_fullboolean · can be null

Whether the subnet is full (SubnetworkN >= MaxAllowedUids): only then does a registration replace a UID. While false, the ranks say who would be replaced once it is full.

owner_immortalboolean

True for an owner-immortal hotkey (one of the subnet owner's first ImmuneOwnerUidsLimit registered hotkeys, the owner hotkey first): never pruned, outside the candidate pool (candidate_rank null). Always false on root.

candidate_rankinteger · unit count · can be null

Position in the prune order among the candidates of basis: 1 = the UID the next registration replaces (when the subnet is full). On a subnet, lowest Emission first (ties: the older registration, then the lower UID: ranks are unique, 1..n); null outside the candidate pool (owner-immortal, or immune while the basis is non_immune). On root, lowest root stake first, every member ranked, and equal stakes share a rank (the chain's order between them is unspecified, tie_order): ranks go 1, 1, 3, ..., so several members can hold rank 1.

replaced_nextboolean

True when the next registration (once the subnet is full) replaces this UID: candidate_rank is 1 and no other UID holds rank 1. On a subnet that is exactly the rank-1 UID. On root, members tied at the lowest stake share rank 1 and the chain picks one of them in an unspecified order, so each is false: a tie at the bottom flags nobody (one of them is still replaced).

basisstring · can be null

Which UIDs are candidates and by what: non_immune (a subnet with more than MinNonImmuneUids UIDs past their ImmunityPeriod: only those, by Emission), immune_fallback (too few: the immune ones, by Emission) or root_stake (root: every member, by root stake; a registration replaces the lowest only when the newcomer's root stake is strictly higher). Clients must accept values not documented yet.

margin_alpha_raostring · unit alpha_rao (÷1e9) · can be null

The gap to the next UID up the prune order: on a subnet the last-epoch Emission gap, in alpha rao of the subnet; on root the root-stake gap, in rao (root alpha is TAO, 1:1): how much more this UID needs to pass it. 0 = tied (see tie_order). Null outside the candidate pool and for the last candidate.

Format: whole number, as a string · can be negative
tie_orderstring

How equal values are ordered: registration_then_uid on a subnet (the older registration goes first, then the lower UID: the runtime's rule, so every rank is unique) or unspecified on root (the chain takes the first lowest stake in storage iteration order, which is not specified: tied members share candidate_rank, and when they tie for rank 1 none is replaced_next). Clients must accept values not documented yet.

dailyarray of objects · can be null

The emission credits through the hotkey per (UTC day, subnet) from meta.from_day to meta.to_day, by day then netuid ([] when none). Only with include=daily: null with include=subnets alone (totals still cover the window), absent without either.

13 fields in daily (each item)
daystring (date)

The UTC day.

Format: date, YYYY-MM-DD
netuidinteger · unit id · can be null

The subnet whose alpha was credited. Null on an aggregated (cross-subnet) row. By default one row per day across the hotkey's subnets (netuid and every alpha member null: alpha of different subnets does not add up; the *_spot_tao_rao members are the sums); daily_netuid gives one subnet's rows instead (this shape per subnet, subnets 1).

by_type_alpha_raoobject · unit alpha_rao (÷1e9) · can be null

The day's credits through the hotkey by type, in alpha rao of netuid: miner_incentive, validator_take, nominator_dividend (paid into the hotkey's pool: its nominators' and owner's stake grows by it; not the operator's income), owner_cut, root_take, root_claimable_queued (a root validator's stakers' dividends on this subnet, queued as claimable) and basket_flush_credit. An open map: only the types credited that day appear, and clients must accept types not documented yet. Null on an aggregated row (by_type_spot_tao_rao there).

by_type_spot_tao_raoobject · unit rao (÷1e9) · can be null

Aggregated rows: each component of by_type_alpha_rao at its subnet's day-close spot, floored per subnet and summed over the priced subnets, rao of TAO (an open map, as by_type_alpha_rao). root_claimable_spot_tao_rao is its root_claimable_queued (checked). Null when no subnet of the day is priced, on a per-subnet row and on an older answer.

root_claimable_spot_tao_raostring · unit rao (÷1e9) · can be null

The root claimable queued that day at spot (accrued, unrealized: never in an amount total), rao of TAO, summed over the priced subnets on an aggregated row. Null on a per-subnet row whose day is unpriced, and on an older answer.

Format: whole number, as a string · on chain: u64
subnetsinteger · unit count · can be null

The subnets in the row (1 on a per-subnet row, checked). Null on an older answer.

unpriced_subnetsinteger · unit count · can be null

The subnets of the row without a day-close price: their credits are missing from the spot sums (0..subnets; on a per-subnet row 1 exactly when total_spot_tao_rao is null, checked). Null on an older answer.

total_alpha_raostring · unit alpha_rao (÷1e9) · can be null

Every credit the hotkey received that day on the subnet, the sum of by_type_alpha_rao (every component), in alpha rao of netuid: a flow total, never the validator's income (it includes root_claimable_queued, accrued and unrealized, and basket_flush_credit, a re-credit of claimable already counted). The income figure is realized_alpha_rao. Null on an aggregated (cross-subnet) row.

Format: whole number, as a string · on chain: u64
total_spot_tao_raostring · unit rao (÷1e9) · can be null

total_alpha_rao at the subnet's price at the day's last credit (1:1 on root), in rao of TAO: a flow total, never income (see realized_spot_tao_rao). Null when no pool price is recorded for it (the pool history starts on 2026-09-27). On an aggregated row: the sum over the priced subnets, each floored (never null; unpriced_subnets counts the subnets left out).

Format: whole number, as a string · on chain: u64
total_spot_usdstring · unit usd · 6 decimals · can be null

total_spot_tao_rao at TAO/USD of the day's close (6 decimals). Null without either price.

Format: decimal number, as a string
realized_alpha_raostring · unit alpha_rao (÷1e9) · can be null

The realized credits only, every component except root_claimable_queued (accrued, unrealized) and basket_flush_credit (a re-credit of claimable already counted): the income figure, in alpha rao of netuid. Exactly total_alpha_rao less those two components (checked). Null on an older answer, and on an aggregated row.

Format: whole number, as a string · on chain: u64
realized_spot_tao_raostring · unit rao (÷1e9) · can be null

realized_alpha_rao at the day's close price (1:1 on root), in rao of TAO. Null exactly when total_spot_tao_rao is (an unpriced day), and on an older answer. On an aggregated row the sum over the priced subnets: total_spot_tao_rao less the root claimable and basket flush credits at spot, within the per-subnet floors (checked).

Format: whole number, as a string · on chain: u64
root_claimable_alpha_raostring · unit alpha_rao (÷1e9) · can be null

The root claimable queued that day (by_type_alpha_rao.root_claimable_queued, 0 when none), in alpha rao of netuid: accrued, unrealized until claimed, never in an amount total. Null on an older answer, and on an aggregated row (root_claimable_spot_tao_rao there).

Format: whole number, as a string · on chain: u64
childkeysarray of objects · optional

Only with include=childkeys beside the detail (include=subnets / daily); absent otherwise (since 2026-10-09: payload size). The hotkey's children, parents and pending child set on every subnet where it has any, whether or not it holds a UID there, by netuid ([] when none). On a subnet with a UID the same as that subnets[] entry's children / parents / pending_children.

4 fields in childkeys (each item)
netuidinteger · unit id

The subnet slot.

childrenarray of objects

ChildKeys: the hotkeys this one delegates stake weight to ([] when none).

2 fields in children (each item)
hotkeystring · can be null

The other hotkey, SS58 (prefix 42).

Format: SS58 address
proportion_ratiostring · unit ratio · 8 decimals · can be null

The proportion (u64 / u64::MAX) as a ratio 0..1, 8 decimals (1.00000000 = all of the parent's).

Pattern: ^[01]\.[0-9]{8}$
parentsarray of objects

ParentKeys: the hotkeys delegating stake weight to this one ([] when none).

2 fields in parents (each item)
hotkeystring · can be null

The other hotkey, SS58 (prefix 42).

Format: SS58 address
proportion_ratiostring · unit ratio · 8 decimals · can be null

The proportion (u64 / u64::MAX) as a ratio 0..1, 8 decimals (1.00000000 = all of the parent's).

Pattern: ^[01]\.[0-9]{8}$
pending_childrenobject · can be null

PendingChildKeys: a scheduled new child set and when it applies. Null when none.

2 fields in pending_children
cooldown_blockinteger · unit block · can be null

The block at which the scheduled set takes effect (its cooldown ends).

childrenarray of objects

The scheduled children, in the chain's order.

childkey_dailyarray of objects · can be null

Only with include=daily: null with include=subnets alone, absent without either. The childkey split per (UTC day, subnet) where the hotkey took part, as a child or as a parent, in amounts actually paid (the runtime's own split lines scaled by each recipient's paid / pre-re-split dividends; Paid amounts can be above or below the split line's own figure, and nothing is taken twice: after the childkey split the runtime splits each hotkey's dividends into an alpha part and a root part by its own stake mix, then rescales each side to its fixed share of validator emission (on SN26 one day: alpha x1.391, root x0.680, the total unchanged), so a hotkey's paid / split ratio can exceed 1: validators staked all in alpha are paid above their split figure, root-heavy ones below.), by day then netuid. A day listed in meta.childkey_missing_days isn't available yet: it has no row, which does not mean zero. On every other day of the window no row means the hotkey had no childkey split that day on that subnet (a real zero).

9 fields in childkey_daily (each item)
daystring (date)

The UTC day.

Format: date, YYYY-MM-DD
netuidinteger · unit id · can be null

The subnet. Null on an aggregated (cross-subnet) row. By default one row per day across the hotkey's subnets (netuid and every alpha member null: alpha of different subnets does not add up; the *_spot_tao_rao members are the sums); daily_netuid gives one subnet's rows instead (this shape per subnet, subnets 1).

take_gained_alpha_raostring · unit alpha_rao (÷1e9) · can be null

Childkey take paid to this hotkey as a child on the subnet: its share, at its childkey take, of the dividends its parents' stake weight earned through it. In alpha rao of the subnet. An amount actually paid: the runtime's split line scaled by the recipient hotkey's paid / pre-re-split dividend ratio (per recipient it equals the emission credits within 10 rao on 5,336 of 5,341 hotkeys; the other 5 are validators without parents that epoch, where only the kept-as-parent share is in the split by definition). Paid amounts can be above or below the split line's own figure, and nothing is taken twice: after the childkey split the runtime splits each hotkey's dividends into an alpha part and a root part by its own stake mix, then rescales each side to its fixed share of validator emission (on SN26 one day: alpha x1.391, root x0.680, the total unchanged), so a hotkey's paid / split ratio can exceed 1: validators staked all in alpha are paid above their split figure, root-heavy ones below. Null on an aggregated (cross-subnet) row.

Format: whole number, as a string
take_paid_alpha_raostring · unit alpha_rao (÷1e9) · can be null

Childkey take paid to this hotkey's children on the subnet out of its share of their dividends (their take on the dividends its stake weight earned through them). In alpha rao of the subnet. An amount actually paid: the runtime's split line scaled by the recipient hotkey's paid / pre-re-split dividend ratio (per recipient it equals the emission credits within 10 rao on 5,336 of 5,341 hotkeys; the other 5 are validators without parents that epoch, where only the kept-as-parent share is in the split by definition). Paid amounts can be above or below the split line's own figure, and nothing is taken twice: after the childkey split the runtime splits each hotkey's dividends into an alpha part and a root part by its own stake mix, then rescales each side to its fixed share of validator emission (on SN26 one day: alpha x1.391, root x0.680, the total unchanged), so a hotkey's paid / split ratio can exceed 1: validators staked all in alpha are paid above their split figure, root-heavy ones below. Null on an aggregated (cross-subnet) row.

Format: whole number, as a string
kept_as_parent_alpha_raostring · unit alpha_rao (÷1e9) · can be null

Dividends paid to this hotkey as a parent: what its stake weight earned through its children on the subnet after their take. In alpha rao of the subnet. An amount actually paid: the runtime's split line scaled by the recipient hotkey's paid / pre-re-split dividend ratio (per recipient it equals the emission credits within 10 rao on 5,336 of 5,341 hotkeys; the other 5 are validators without parents that epoch, where only the kept-as-parent share is in the split by definition). Paid amounts can be above or below the split line's own figure, and nothing is taken twice: after the childkey split the runtime splits each hotkey's dividends into an alpha part and a root part by its own stake mix, then rescales each side to its fixed share of validator emission (on SN26 one day: alpha x1.391, root x0.680, the total unchanged), so a hotkey's paid / split ratio can exceed 1: validators staked all in alpha are paid above their split figure, root-heavy ones below. Null on an aggregated (cross-subnet) row.

Format: whole number, as a string
take_gained_spot_tao_raostring · unit rao (÷1e9) · can be null

take_gained_alpha_rao at the subnet's day-close spot, floored, rao of TAO; summed over the subnets on an aggregated row (an unpriced subnet adds 0). Null on a per-subnet row whose day is unpriced (with the other two spot members, checked), and on an older answer.

Format: whole number, as a string · on chain: u64
take_paid_spot_tao_raostring · unit rao (÷1e9) · can be null

take_paid_alpha_rao at spot, as take_gained_spot_tao_rao.

Format: whole number, as a string · on chain: u64
kept_as_parent_spot_tao_raostring · unit rao (÷1e9) · can be null

kept_as_parent_alpha_rao at spot, as take_gained_spot_tao_rao.

Format: whole number, as a string · on chain: u64
subnetsinteger · unit count · can be null

The subnets in the row (1 on a per-subnet row, checked; at least 1 on an aggregated row). Null on an older answer.

totalsvalue · optional

Detail (include=subnets / daily); absent otherwise. daily and childkey_daily summed over the window.

basketobject · can be null

Only with include=basket (absent otherwise): the fund this hotkey runs, exactly as GET /baskets/{hotkey}'s data at the latest available day end (no sections); its day, coverage and version are meta.sections.basket. Null when the hotkey runs no fund (a hotkey whose staking_options.fund block is set never has a null basket: checked). At most 20 hotkeys per request with it (400 BATCH_TOO_LARGE). With include=basket_holdings (which implies basket) it also carries holdings_by_subnet, as GET /baskets/{hotkey}?include=holdings_by_subnet serves it.

43 fields in basket
hotkeystring

The validator running the fund, SS58 (prefix 42).

Format: SS58 address
account_kindobject

What the hotkey is, from its bytes.

4 fields in account_kind
kindstring

custody: a module account that holds other accounts' funds (the subnet pool accounts, the basket escrow, crowdloan funds, the limit-order intermediary), so its balance is not its own: leave it out of rankings of holders. protocol: any other module account. account: no module-account prefix; it may still be a multisig, a pure proxy or an EVM-mapped account (those cannot be told apart from the bytes). New values may be added; show an unknown value as is (or generically).

pallet_idstring · can be null

The module account's PalletId, the 8 bytes after the modl prefix as text (e.g. subtensr, bt/cloan). Null when kind is account.

subobject · can be null

The sub-account the bytes after the PalletId decode to. Null for a plain account, for a PalletId's base account, and for sub-account bytes that do not decode.

namestring · can be null

A readable name for the module account from a registry of known PalletIds (e.g. subnet pool account, basket escrow). Null when the registry does not know the account; never guessed.

daystring (date)

The UTC day.

Format: date, YYYY-MM-DD
heightinteger · unit block

The day's last block (the day end everything is read at).

shares_unitsstring · unit shares · can be null

BasketShares: the fund's units outstanding. Null when not readable.

Format: whole number, as a string
sum_owed_unitsstring · unit shares

The units owed to the holders, summed (each holder's capped at the fund's units, as the runtime caps it).

Format: whole number, as a string
sum_owed_sourcestring

Always derived (an opaque identifier): a computed sum, not a chain value. New values may be added; show an unknown value as is (or generically).

unowed_shares_unitsstring · unit shares · can be null

shares_units - sum_owed_units: units no holder is owed (from stated facts; their origin is not attributed yet). May be negative by a few units: the runtime's rate accrual over-entitles holders by dust (claims are capped at the fund's shares). Null with shares_units.

Format: whole number, as a string · can be negative
unowed_shares_sourcestring

Always derived (an opaque identifier): a computed figure, not a chain value. New values may be added; show an unknown value as is (or generically).

n_stakersinteger · unit count

The fund's stakers at the day end: the (fund hotkey, coldkey) pairs holding a root share key (Alpha / AlphaV2 on netuid 0) OR a BasketClaimed record, the fund escrow excluded. It includes stakers whose root stake is now 0 with a claim record; dust is not excluded. The stakers with stake are n_stakers_with_stake.

n_stakers_with_stakeinteger · unit count · can be null

The stakers with root stake > 0 at the day end (the count usually shown as "Stakers"): a subset of n_stakers (at most it, checked); dust not excluded. Null on a day from before this figure was recorded, and on an older data version's answer.

nav_tao_raostring · unit rao (÷1e9) · can be null

The runtime's realizable (slippage-aware) NAV at the day's close, rao. Null when the runtime call was not available.

Format: whole number, as a string · on chain: u64
total_root_raostring · unit rao (÷1e9)

The validator's total root stake the owed units accrue on, rao.

Format: whole number, as a string · on chain: u64
spot_nav_tao_raostring · unit rao (÷1e9) · can be null

The NAV at spot prices, rao (labelled spot: not realizable). Null when not available.

Format: whole number, as a string · on chain: u64
deposited_tao_raostring · unit rao (÷1e9) · can be null

TAO deposited into the fund, rao. Null when not available.

Format: whole number, as a string · on chain: u64
redeemed_tao_raostring · unit rao (÷1e9) · can be null

TAO redeemed from the fund, rao. Null when not available.

Format: whole number, as a string · on chain: u64
holdingsinteger · unit count · can be null

Subnet positions the fund holds. Null when not available.

pricingobject

The chain's fund pricing at the day end (BetaBaseline / BasketTwr / BetaIndexSnapshot and the runtime's spot NAV): the same values BetaBasketRuntimeApi.get_beta_pricing returns.

13 fields in pricing
provisionalboolean · can be null

True when the fund has no BetaBaseline: it prices at the live index until its next mint stamps it, and display_price, stake_price, staker_twr and both vs-index ratios are null. A flag, never a 0: key on it, not on a zero price. Null while the day's pricing isn't available yet (vs_index_unavailable_reason is then not_ready and every figure is null): unknown, not provisional.

first_blockinteger · unit block · can be null

The stamp block: where the display line begins. Null while provisional.

spot_pricestring · unit rao_per_share · 12 decimals · can be null

The spot NAV per share (raw): spot NAV / units outstanding, rao per unit, 12 decimals. Null without units or a NAV.

Format: decimal number, as a string · can be negative
display_pricestring · unit coefficient · 12 decimals · can be null

spot_price / BetaBaseline.price_divisor: the fund's price spliced onto the bag index at the stamp (a level), 12 decimals. Null while provisional.

Format: decimal number, as a string · can be negative
stake_pricestring · unit coefficient · 12 decimals · can be null

tr_splice x BasketTwr: the staker's price line (a level), 12 decimals. Null while provisional or staker_twr_defaulted.

Format: decimal number, as a string · can be negative
staker_twrstring · unit coefficient · 12 decimals · can be null

BasketTwr: the staker total-return level since the life's start (not annualised), 12 decimals. Null while provisional or staker_twr_defaulted.

Format: decimal number, as a string · can be negative
staker_twr_defaultedboolean · can be null

True when there is no BasketTwr key (no dividend minted in this life): staker_twr, stake_price and vs_index_stake_ratio are null. Null while the day's pricing isn't available yet (as provisional).

bag_indexstring · unit coefficient · 12 decimals · can be null

BetaIndexSnapshot's bag index level at the day end, 12 decimals. Null before the first snapshot.

Format: decimal number, as a string · can be negative
stake_indexstring · unit coefficient · 12 decimals · can be null

BetaIndexSnapshot's stake index level at the day end, 12 decimals. Null before the first snapshot.

Format: decimal number, as a string · can be negative
index_blockinteger · unit block · can be null

The published index snapshot's block. Null without one.

vs_index_bag_ratiostring · unit ratio · 12 decimals · can be null

display_price / bag_index - 1 (the quotient at 12 decimals): the cumulative excess over the bag index since the stamp, a signed ratio. A spot-marked numerator against a realizable-marked index, so a thin pool reads its spot-realizable gap as excess. Null with vs_index_unavailable_reason.

Format: decimal number, as a string · can be negative
vs_index_stake_ratiostring · unit ratio · 12 decimals · can be null

stake_price / stake_index - 1, a signed ratio, 12 decimals. Null with vs_index_unavailable_reason (or staker_twr_defaulted).

Format: decimal number, as a string · can be negative
vs_index_unavailable_reasonstring · can be null

Why both vs-index ratios are null; null when they are given. Precedence provisional > fund_reset (a reset on any anchor since the stamp, the current day's claim anchors included) > dust_fund (now: units < 1e9 or realizable NAV < 1 TAO); not_ready while the day's pricing isn't available yet (provisional and staker_twr_defaulted are null then). insufficient_history is the same case on an older data version's answer. New values may be added; treat unknown values as unavailable.

returnsobject

The fund's 7- and 30-day NAV-per-unit returns and the staker's TWR over the same windows.

8 fields in returns
return_7d_ratiostring · unit ratio · 12 decimals · can be null

The realizable NAV per unit at the served day end over the one 7 day ends before, minus 1: a signed ratio, 12 decimals. Null with return_7d_unavailable_reason.

Format: decimal number, as a string · can be negative
return_7d_unavailable_reasonstring · can be null

Why return_7d_ratio is null: any refused day refuses the window, precedence fund_reset (units drained through 1e9, or a day's NAV-per-unit ratio above 2 or under 0.5) > share_collapse (close units under half the open's) > dust_fund (units under 1e9 or NAV under 1 TAO) > insufficient_history (a missing day, or the window starts before the available series). Null when given. New values may be added; treat unknown values as unavailable.

staker_twr_7d_ratiostring · unit ratio · 12 decimals · can be null

BasketTwr(day) / BasketTwr(day - 7) - 1: the staker's 7-day total return, a signed ratio, 12 decimals. Null with staker_twr_7d_unavailable_reason.

Format: decimal number, as a string · can be negative
staker_twr_7d_unavailable_reasonstring · can be null

insufficient_history (the life changed, or a side has no BasketTwr) exactly when staker_twr_7d_ratio is null; null otherwise. New values may be added; treat unknown values as unavailable.

return_30d_ratiostring · unit ratio · 12 decimals · can be null

The same over the 30 day ends ending at the served day: a signed ratio, 12 decimals. Null with return_30d_unavailable_reason.

Format: decimal number, as a string · can be negative
return_30d_unavailable_reasonstring · can be null

Why return_30d_ratio is null, as return_7d_unavailable_reason. Null when given. Known values: fund_reset, share_collapse, dust_fund, insufficient_history. New values may be added; treat unknown values as unavailable.

staker_twr_30d_ratiostring · unit ratio · 12 decimals · can be null

BasketTwr(day) / BasketTwr(day - 30) - 1, a signed ratio, 12 decimals. Null with staker_twr_30d_unavailable_reason.

Format: decimal number, as a string · can be negative
staker_twr_30d_unavailable_reasonstring · can be null

As staker_twr_7d_unavailable_reason, for 30 days. Known values: insufficient_history. New values may be added; treat unknown values as unavailable.

stakingobject

The validator's staking figures at the served day, blended over its pools (subnets AND root) by each pool's TAO value at its window open; each pool annualised over its own day count. Any staked pool without a value makes a figure null (no partial blend), with unavailable_reason. The top-level figures cover every pool, root included; subnet_only the subnet pools only (netuid != 0).

13 fields in staking
poolsinteger · unit count · can be null

The validator's staked pools blended: every pool, root included (subnets and root).

pools_refusedinteger · unit count · can be null

Pools whose per-share return was refused (a share restart, or no history).

window_daysobject

The pools' window lengths.

reference_stake_tao_raostring · unit rao (÷1e9) · can be null

The day's reference stake, rao (the 30-day median real stake-add; 10 TAO fallback): what the reference figures and the costs are for. Null before the first reference day.

Format: decimal number, as a string · can be negative
nominator_apy_ratiostring · unit ratio · 8 decimals · can be null

Σ w ((1 + y)^(365 / days) - 1) / Σ w: y = the pool's per-share return (TotalHotkeyAlpha / shares) over its window, net of the validator's take, alpha-denominated (the price move is not included); w = the pool's TAO value at its window open. The ROOT pool's y is its accrued root claimable over meta.root_yield_window against its root stake at the window open (pool-wide, net of take, at spot, before a claim's swap cost and RootClaimableThreshold): accrued, not realised. A rate, never a stake or income total. A signed ratio, 8 decimals. Null when a pool is refused (or none).

Format: decimal number, as a string · can be negative
apy_at_reference_stake_ratiostring · unit ratio · 8 decimals · can be null

The same on y x M: the APY a new stake of reference_stake_tao_rao would earn, with M the dilution of the reference stake X joining the pool (root: A / (A + X); a subnet: T/(T+X) x (s+X+K)/(s+K) x (A+R)/(A+X+R)). A constant-dividend model, the dividend held constant when X joins, so it understates under Yuma, where the dividend grows with stake. 8 decimals. Null with unavailable_reason (refused, no reference stake, an unpriced pool).

Format: decimal number, as a string · can be negative
reference_apr_ratiostring · unit ratio · 8 decimals · can be null

Σ w (y M x 365 / days) / Σ w: the simple (uncompounded) APR at the reference stake, breakeven_days' rate. 8 decimals. Null as apy_at_reference_stake_ratio.

Format: decimal number, as a string · can be negative
round_trip_cost_ratiostring · unit ratio · 8 decimals · can be null

1 - TAO back / the reference TAO, blended over the pools: the runtime's swap simulation at the day-end block (buy, then sell the alpha back against the same pool state); root 0. 8 decimals. Null while a pool's simulation is pending, or without a reference stake.

Format: decimal number, as a string · can be negative
entry_cost_ratiostring · unit ratio · 8 decimals · can be null

1 - alpha out x spot / the reference TAO, blended; root 0. 8 decimals. Null as round_trip_cost_ratio.

Format: decimal number, as a string · can be negative
exit_cost_ratiostring · unit ratio · 8 decimals · can be null

1 - TAO back / (alpha out x spot), blended; root 0. 8 decimals. Null as round_trip_cost_ratio.

Format: decimal number, as a string · can be negative
breakeven_daysstring · unit days · 2 decimals · can be null

round_trip_cost_ratio / (reference_apr_ratio / 365): the days the reference stake must stay to earn back its round trip, dividing exactly the cost served beside it by the APR served beside it (2 decimals). Null when either is, or when the served APR is not above 0 (unavailable_reason no_yield).

Format: decimal number, as a string · can be negative
unavailable_reasonstring · can be null

Why figures are null (precedence in this order): no_pools (no staked pool), pool_refused (a pool's return was refused: every APY and APR null), parent_set_unknown (a staked pool carries material childkey take, so its yield is rated over 1 day only until its per-day parent sets are stored) and window_too_short (a staked pool's yield window is shorter than its full window, 7 days or root's 30: a younger pool), either nulling every APY, the APR and the breakeven while the costs stay when known (parent_set_unknown is served when both hold), no_reference_stake (the reference figures and the costs null), pool_unpriced (a pool has no spot price: the reference APY, APR and breakeven null; nominator_apy_ratio stands), not_ready (the day's stake weights are not available yet: as pool_unpriced), swap_cost_pending (a pool's swap simulation has not run: the costs and breakeven null) or no_yield (the served reference_apr_ratio is not above 0, so only breakeven_days is null; the APYs, the APR and the costs are given). Null when every figure is given. New values may be added; treat unknown values as unavailable.

subnet_onlyobject · can be null

The same figures over the subnet pools only (netuid != 0; root apart): root's low yield and zero swap cost no longer dilute them. The top-level figures stay the blend over every pool, root included. Null on an older data version's answer.

sparkline_7d_nav_per_unitarray of string · unit rao_per_share · 12 decimals · can be null

The realizable NAV per unit (rao per unit, 12 decimals) at the last 8 UTC day-end closes, oldest first; a day not available yet is absent, a day without units is null. Null on an older data version's answer.

trades_7dinteger · unit count · can be null

BasketSwapped events of the fund over the 7 days (50,400 blocks) to the day end. Null on an older data version's answer.

volume_7d_tao_raostring · unit rao (÷1e9) · can be null

The TAO leg at mid (taoMid) of those swaps, summed, rao. Null on an older data version's answer.

Format: whole number, as a string
owner_coldkeystring · can be null

Owner(hotkey) at the state head: the coldkey owning the validator, SS58 (prefix 42). Null on an older data version's answer.

Format: SS58 address
owner_namestring · can be null

The owner coldkey's on-chain identity name. Null without one. Null on an older data version's answer.

take_ratiostring · unit ratio · 6 decimals · can be null

Delegates take at the state head (u16 / 65535), a ratio, 6 decimals. Null when unset. Null on an older data version's answer.

Format: decimal number, as a string
dissolvedboolean · can be null

True when the fund is dissolved: absent from the runtime's basket list at the 2 swept anchors after its last one with units, and its BasketShares gone at the state head. A dissolved fund's page serves its last available day. Null on an older data version's answer.

dissolved_heightinteger · unit block · can be null

The first anchor the fund was absent at. Null unless dissolved. Null on an older data version's answer.

root_uidinteger · unit id · can be null

The fund hotkey's UID on root (netuid 0). Null when it is not registered on root. Null on an older data version's answer.

trading_statusobject · can be null

The fund's swap_basket gate and turnover bucket at the state head (not the served day end): served only when no at is asked (meta.head_fields), null with one. Null too when the fund has no swept holdings, and on an older answer.

9 fields in trading_status
is_trading_enabledboolean

BasketTradingEnabled: the network-wide switch.

is_frozenboolean

BasketTradingFrozen[hotkey]: governance froze this fund.

refill_blocksinteger · unit blocks

The bucket's refill window, blocks (a full refill per window).

tao_available_raostring · unit rao (÷1e9)

The bucket now: its stored level plus budget x elapsed / refill_blocks, capped at the budget (full when no bucket is stored), rao.

Format: whole number, as a string · on chain: u64
budget_raostring · unit rao (÷1e9)

The bucket's capacity: guarded NAV x BasketDailyTurnoverCap / 65535, rao.

Format: whole number, as a string · on chain: u64
guarded_nav_tao_raostring · unit rao (÷1e9)

The NAV the budget is a share of: per holding min(realizable, moving price x alpha) (root: realizable) at the fund's newest swept anchor (nav_as_of_block), rao. It can sit a little off the chain's while prices move.

Format: whole number, as a string · on chain: u64
as_of_blockinteger · unit block

The state head the status is read at.

nav_as_of_blockinteger · unit block

The swept anchor the guarded NAV is read at.

sourcestring

A constant marker (one value today, chain): the status is computed from chain state. New values may be added; show an unknown value as is (or generically).

nav_unavailable_reasonstring · can be null

Why nav_tao_rao is null: no_nav_row (no NAV row swept at the day end). Null otherwise, and on an older answer. Known values: no_nav_row, unpriced_holding, fund_dissolved. New values may be added; treat unknown values as unavailable.

pending_depositsarray of objects · can be null

The fund's dividends queued for it per subnet and not yet flushed in, at the state head, by netuid; [] when none. Raw alpha, never valued: not part of any NAV or total. Null when an at is asked (read at the head only: meta.head_fields). Null on an older data version's answer.

2 fields in pending_deposits (each item)
netuidinteger · unit id

The subnet.

alpha_raostring · unit alpha_rao (÷1e9)

The raw alpha queued, alpha rao of netuid. Never valued (not part of the fund's NAV yet).

Format: whole number, as a string · on chain: u64
holding_countinteger · unit count · can be null

The subnets the fund holds alpha in (alpha > 0) at its newest swept anchor at or before the day end: the same composition as include=holdings_by_subnet, counted. Null before the fund's first swept anchor. Null on an older data version's answer.

root_stakeobject · can be null

Option A: root stake to the fund's validator, with its holder-true accrual, realised claims, staker TWR and hold return as RatioFigures. Never combined with fund (no rate across options). Stored once per accrual day with its own as_of_day / as_of_height: the block of the latest accrual day, whatever day the list serves (so an answer carrying it is never cached as settled). Null before the fund's first store.

21 fields in root_stake
optionstring

Always root_stake.

basisstring

The rate basis: the accrued claimable, holder-true. Known values: root_claimable_holder. New values may be added; show an unknown value as is (or generically).

has_root_uidboolean

The hotkey holds a root UID at as_of_height.

root_stake_tao_raostring · unit rao (÷1e9)

TotalHotkeyAlpha(hotkey, 0) at as_of_height (root is 1:1), rao of TAO: the pool the accrual dilutes over. 0 when none.

Format: whole number, as a string · on chain: u64
take_ratiostring · unit ratio · 6 decimals · can be null

The Delegates take at the head, 0..1 (6 decimals). Null without a Delegates entry.

Format: decimal number, as a string
apy_7dobject

Holder-true accrual (APY): the fund units a TAO of root stake held through the window accrued, each day at that day's own realizable NAV per unit (the value at accrual), annualised; net of take, before the claim, the escrow share excluded. A rate, never an amount, and accrued: unrealised until claimed. NAV moves after the mint are hold_return_*, never here.

apy_30dobject

The same over 30 days.

accrual_period_return_7dstring · unit ratio · 12 decimals · can be null

The 7-day window's period return y behind apy_7d: the daily holder-true accrual summed over the window, 12 decimals (apy_7d = (1 + y)^(365/7) - 1, checked within its rounding). Exact where the 8-decimal APY rounds: compose an accrual at an amount from this, never from the APY. A rate, never an amount, and accrued. Null exactly when apy_7d is (checked), and on an answer from before it.

Format: decimal number, as a string · can be negative
accrual_period_return_30dstring · unit ratio · 12 decimals · can be null

The same over the 30-day window (apy_30d = (1 + y)^(365/30) - 1). Null exactly when apy_30d is.

Format: decimal number, as a string · can be negative
realised_apy_7dobject

The root claims executed on the hotkey in the window (BasketClaimed.tao) over the mean root stake held, annualised: the realised cross-check, lumpy.

realised_apy_30dobject

The same over 30 days.

staker_twr_7dobject

BasketTwr over the window (claim and restake, each dividend at realizable value), a period return.

staker_twr_30dobject

The same over 30 days.

hold_return_7dobject

Hold without claiming: the units accrued in the window marked at realizable NAV per unit at its end against their value at accrual, a period return. Served beside apy_7d, never added to it.

hold_return_30dobject

The same over 30 days.

sell_gate_7dobject

The root-sell gate over the 7-day window.

sell_gate_30dobject

The root-sell gate over the 30-day window.

risk_principalobject

The principal's risk: low.

risk_accrualobject

The accrual's risk: medium (it sits in the fund's units).

as_of_daystring (date) · can be null

The to_day of the block's figures: the last available UTC day. Null while none is available.

Format: date, YYYY-MM-DD
as_of_heightinteger · unit block

The block the head values (stake, take, root UID) are read at, at or below meta.at.

fundobject · can be null

Option B: the fund units, the full block (state, NAVs and unit values, holder returns, composition, trading, display, risk). Stored once per accrual day like root_stake, with its own as_of_*. Null when not stored.

21 fields in fund
optionstring

Always fund_units.

statestring

dissolved (worth exactly 0); no_state (no units outstanding, nothing held); off_root (units outstanding, no root UID: holders can still claim); active (units and a root UID). Checked against has_root_uid. New values may be added; show an unknown value as is (or generically).

has_root_uidboolean

The hotkey holds a root UID at as_of_height.

nav_realizable_tao_raostring · unit rao (÷1e9) · can be null

The fund's realizable NAV (its holdings as sold through each pool), rao of TAO. Null with nav_unavailable_reason (a dissolved fund's is null with fund_dissolved, checked), and on no_state.

Format: whole number, as a string · on chain: u64
nav_spot_tao_raostring · unit rao (÷1e9) · can be null

Its spot NAV (display), rao of TAO. Null together with the realizable NAV.

Format: whole number, as a string · on chain: u64
nav_unavailable_reasonstring · can be null

Why the NAVs are null (fund_dissolved: the fund is dissolved); null when they are given. Known values: no_nav_row, unpriced_holding, fund_dissolved. New values may be added; treat unknown values as unavailable.

units_outstandingstring · unit count · can be null

BasketShares: the fund's units outstanding (units, not TAO). Null on no_state.

Format: whole number, as a string
sum_owed_unitsstring · unit count · can be null

The units its holders are owed, summed (units).

Format: whole number, as a string
unowed_unitsstring · unit count · can be null

Units outstanding no holder is owed (units); a negative one is served as stated (a data-source defect, reported).

Format: whole number, as a string · can be negative
unit_value_realizable_raostring · unit rao_per_share · can be null

The realizable NAV per unit (rao of TAO per unit, 12 decimals). Null without a NAV or units.

Format: decimal number, as a string
unit_value_spot_raostring · unit rao_per_share · can be null

The spot NAV per unit (rao of TAO per unit). Null with the realizable one.

Format: decimal number, as a string
holder_return_7dobject

Option B's headline: the realizable NAV per unit over the window's day ends, minus 1, a period return (not annualised; flow-invariant, TAO terms).

holder_return_30dobject

The same over 30 days.

n_stakersinteger · unit count · can be null

The fund's stakers at its latest available day end (the fund row's n_stakers): the (fund hotkey, coldkey) pairs holding a root share key (Alpha / AlphaV2 on netuid 0) OR a BasketClaimed record, the fund escrow excluded; it includes stakers whose root stake is now 0 with a claim record, and dust is not excluded. The stakers with root stake > 0 are the fund row's n_stakers_with_stake (GET /baskets/{hotkey}).

first_blockinteger · unit block · can be null

The fund's first block. Null on no_state.

riskobject

The units' risk: high.

as_of_daystring (date) · can be null

The fund's latest available UTC day (the figures' to_day).

Format: date, YYYY-MM-DD
as_of_heightinteger · unit block

The block the head values are read at.

displayvalue · optional

The display figures. Absent on a block that carries none.

compositionvalue · optional

The holdings' concentration at the fund's newest swept anchor at or before the day close. Absent where it is not served (directory rows, an older answer).

tradingvalue · optional

The trading status, 7-day swaps and the 30-day turnover. Absent where it is not served (directory rows, an older answer).

subnet_stake_spot_tao_raostring · unit rao (÷1e9) · can be null

The validator's stake on the subnets (netuid >= 1) at spot, rao of TAO (the validators index): a value, never a rate. Null when any staked pool is unpriced (never a partial sum) or the hotkey is not indexed. Null on an older data version's answer.

Format: whole number, as a string · on chain: u64
staked_subnet_countinteger · unit count · can be null

Subnets where the validator's pool holds stake (TotalHotkeyAlpha > 0; the validators index): a count, never a rate. Null when the hotkey is not indexed. Null on an older data version's answer.

first_funded_heightinteger · unit block · can be null

The first block with units outstanding (BasketShares > 0) at or before the served day end: where the fund was first funded, as far as the data source reaches back (first_funded_is_lower_bound). Null when the fund had no units outstanding by the day end (with the flag). Null on an older data version's answer.

first_funded_is_lower_boundboolean · can be null

True when first_funded_height is the data source's first recorded block for this fund (it was funded at or before it, so the true first block may be older and a fund age from it is a minimum); false when it is the exact first funded block. Null exactly with first_funded_height.

seriesarray of objects · optional

Only with include=series (absent otherwise): the fund's day ends of the 90 days ending at meta.day (fewer near the first available day), oldest first; each with that day's pricing.

18 fields in series (each item)
hotkeystring

The validator running the fund, SS58 (prefix 42).

Format: SS58 address
account_kindobject

What the hotkey is, from its bytes.

daystring (date)

The UTC day.

Format: date, YYYY-MM-DD
heightinteger · unit block

The day's last block (the day end everything is read at).

shares_unitsstring · unit shares · can be null

BasketShares: the fund's units outstanding. Null when not readable.

Format: whole number, as a string
sum_owed_unitsstring · unit shares

The units owed to the holders, summed (each holder's capped at the fund's units, as the runtime caps it).

Format: whole number, as a string
sum_owed_sourcestring

Always derived (an opaque identifier): a computed sum, not a chain value. New values may be added; show an unknown value as is (or generically).

unowed_shares_unitsstring · unit shares · can be null

shares_units - sum_owed_units: units no holder is owed (from stated facts; their origin is not attributed yet). May be negative by a few units: the runtime's rate accrual over-entitles holders by dust (claims are capped at the fund's shares). Null with shares_units.

Format: whole number, as a string · can be negative
unowed_shares_sourcestring

Always derived (an opaque identifier): a computed figure, not a chain value. New values may be added; show an unknown value as is (or generically).

n_stakersinteger · unit count

The fund's stakers at the day end: the (fund hotkey, coldkey) pairs holding a root share key (Alpha / AlphaV2 on netuid 0) OR a BasketClaimed record, the fund escrow excluded. It includes stakers whose root stake is now 0 with a claim record; dust is not excluded. The stakers with stake are n_stakers_with_stake.

n_stakers_with_stakeinteger · unit count · can be null

The stakers with root stake > 0 at the day end (the count usually shown as "Stakers"): a subset of n_stakers (at most it, checked); dust not excluded. Null on a day from before this figure was recorded, and on an older data version's answer.

nav_tao_raostring · unit rao (÷1e9) · can be null

The runtime's realizable (slippage-aware) NAV at the day's close, rao. Null when the runtime call was not available.

Format: whole number, as a string · on chain: u64
total_root_raostring · unit rao (÷1e9)

The validator's total root stake the owed units accrue on, rao.

Format: whole number, as a string · on chain: u64
spot_nav_tao_raostring · unit rao (÷1e9) · can be null

The NAV at spot prices, rao (labelled spot: not realizable). Null when not available.

Format: whole number, as a string · on chain: u64
deposited_tao_raostring · unit rao (÷1e9) · can be null

TAO deposited into the fund, rao. Null when not available.

Format: whole number, as a string · on chain: u64
redeemed_tao_raostring · unit rao (÷1e9) · can be null

TAO redeemed from the fund, rao. Null when not available.

Format: whole number, as a string · on chain: u64
holdingsinteger · unit count · can be null

Subnet positions the fund holds. Null when not available.

pricingobject · can be null

On a series day: a copy of the fund page's data.pricing for that day (null on an older data version's answer). On the fund itself (BasketDetail) always given.

holdersarray of objects · optional

Only with include=holders (absent otherwise): the first child_limit holders at meta.day, by owed units descending, as GET /baskets/{hotkey}/holders?day=<meta.day>&limit=<child_limit> answers them; meta.sections.holders.page.next_cursor continues that request.

7 fields in holders (each item)
coldkeystring

The holder (a root staker of the validator), SS58.

Format: SS58 address
account_kindobject

What the holder is, from its bytes.

root_stake_raostring · unit rao (÷1e9)

Its root stake on the validator, rao.

Format: whole number, as a string · on chain: u64
owed_unitsstring · unit shares

The fund units it is owed.

Format: whole number, as a string
claimed_unitsstring · unit shares

The units it has claimed.

Format: whole number, as a string
income_unitsstring · unit shares · can be null

The day's basket-unit income. Null on the holder's first available day.

Format: whole number, as a string
income_tao_raostring · unit rao (÷1e9) · can be null

income_units valued at the fund's NAV per unit (pre-claim / close anchors), floored, rao. Null with income_units.

Format: whole number, as a string · on chain: u64
holdings_by_subnetobject · can be null

Only with include=holdings_by_subnet (absent otherwise): the runtime's per-subnet holdings (BasketSummary.holdings) at the fund's latest swept anchor at or before the day end. Null before the first sweep that kept them (they are stored from 2026-10-03 on).

2 fields in holdings_by_subnet
heightinteger · unit block

The fund's latest swept anchor at or before the day end: the block the holdings are read at.

holdingsarray of objects

One row per subnet the fund holds.

eventsarray of objects · optional

Only with include=events (absent otherwise): the fund's newest child_limit events (BasketDeposited, BasketClaimed, BasketSwapped, BasketClaimDustSkipped, BasketStakedIn, BasketAlphaWrittenOff, BasketHoldingConverted) at the head, not the day end, as GET /baskets/{hotkey}/events?limit=<child_limit> answers them; meta.sections.events.page.next_cursor continues that request.

12 fields in events (each item)
idstring · unit id

The event's id, {height}-{index} (index = its position in the block's System.Events).

Format: block and index, such as 4200000-3
heightinteger · unit block

The block it was emitted in.

indexinteger · unit id

Its index in the block's System.Events (0-based).

timestring (date-time) · can be null

The block's Timestamp.set (RFC 3339 UTC, milliseconds). Null for block 0 only.

Format: date and time, ISO 8601 in UTC
phasestring

When it was emitted: initialization (block hooks before the extrinsics, e.g. emission), extrinsic (while applying an extrinsic) or finalization (block hooks after them; none after block 9,155,260). New values may be added; show an unknown value as is (or generically).

extrinsic_idstring · unit id · can be null

The extrinsic it was emitted under ({height}-{index}); null in the initialization and finalization phases.

Format: block and index, such as 4200000-3
dispatch_phasestring · can be null

Where in applying its extrinsic the event was emitted, from the chain's per-event trace: pre_dispatch (before the call ran: the fee withdraw), dispatch (by the call or the calls it dispatched) or post_dispatch (after it: the fee refund, TransactionFeePaid, System.ExtrinsicSuccess / ExtrinsicFailed). Null outside the extrinsic phase, and below block 7,089,968 (before the trace covers). New values may be added; show an unknown value as is (or generically).

call_idstring · unit id · can be null

The call that emitted it (a call id). Null outside a dispatched call: the block phases, and the extrinsic's pre- and post-dispatch events (dispatch_phase pre_dispatch / post_dispatch: the fee withdraw, the refund, TransactionFeePaid, ExtrinsicSuccess / ExtrinsicFailed), which no call emits, so per-call event lists and counts never include them. Below block 7,089,968 (dispatch_phase null) the attribution is the event dictionary's, which puts a wrapper's pre-dispatch events on its first child.

Pattern: ^[0-9]+-[0-9]+(\.[0-9]+)*$
eventobject

The event's kind.

argsobject · can be null

The arguments as named fields, served exactly as the data source renders them (never re-rendered here). Names: the block's runtime metadata names each field (snake_case); unnamed tuple fields take their names from a reviewed list of override names (each entry traced to the subtensor source), else the snake_case of the field's type name (_2, _3 when repeated), else arg0, arg1. A field typed NetUidStorageIndex is always netuid_index (= mechanism × 4096 + netuid), never a netuid. Values: accounts (AccountId32 by metadata type) are SS58; amounts are decimal strings in their base unit; enums are {__kind, value}; hashes and bytes are 0x hex; a nested call (batch, proxy, sudo) is {pallet, name, args}. The naming rule and the override names are versioned in meta.data_version (args/<rule>.<overrides>), so a renamed field is a new version. Free-form: the members depend on the kind and the runtime, so this schema does not list them. Null only when the source stored no arguments.

error_palletstring · can be null

The DispatchError this event carries, decoded with the block's runtime: for a module error the pallet that raised it (e.g. Swap), as an extrinsic's error.pallet. Carried by System.ExtrinsicFailed, Utility.BatchInterrupted / ItemFailed, and the Err results of Proxy.ProxyExecuted, Multisig.MultisigExecuted, Sudo.Sudid / SudoAsDone, Utility.DispatchedAs and Scheduler.Dispatched. Null on every other event, on an Ok result, for a non-module error (BadOrigin, Token, ...) and when the error could not be decoded.

error_namestring · can be null

The DispatchError's name, as an extrinsic's error.name: a module error's (e.g. PriceLimitExceeded, HotKeyAlreadyRegisteredInSubNet), or the inner variant of a Token / Arithmetic / Transactional error (error_pallet then null). Null when the event carries no DispatchError, or it has no name (BadOrigin, an undecoded error).

Response headers

10 headers: ETag, Cache-Control, CDN-Cache-Control, X-BTAI-Stale, X-BTAI-Stale-As-Of, RateLimit-Policy, RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
ETag

Strong validator of this answer. Send it back as If-None-Match: an unchanged answer is a 304 Not Modified without a body. A settled answer's validator leaves the chain head out, so it stays valid as the head moves.

Cache-Control

One of three classes: settled public, max-age=3600, stale-while-revalidate=86400 (pinned to a block that cannot move), slow public, max-age=300, stale-while-revalidate=600 (state that moves in minutes or days) or tip public, max-age=6, stale-while-revalidate=12 (follows the chain head); the label routes are cached until the next nightly copy (public, max-age=<seconds>, stale-while-revalidate=60). Never immutable. no-store on an earlier answer served because the data source failed (X-BTAI-Stale).

CDN-Cache-Control

The same class for shared caches (RFC 9213; browsers ignore it): settled 24 h, slow 300 s, tip 6 s, each with stale-while-revalidate and stale-if-error; no-store with X-BTAI-Stale.

X-BTAI-Stale

Present only when the data source failed to answer (it timed out or was unavailable) and an earlier answer to the same request is served instead of a 503 (stale if error, RFC 5861). Then if-error, with X-BTAI-Stale-As-Of, Age (its seconds since then) and Warning: 110 - "Response is Stale", and Cache-Control: no-store: the answer is never kept as fresh, and a later request reads again. Prices and quotes are never served this way.

X-BTAI-Stale-As-Of

With X-BTAI-Stale: when the earlier answer served was produced, an RFC 3339 UTC time (2026-10-21T12:00:00Z).

RateLimit-Policy

The tier's request quota of the current window (IETF draft), e.g. "tier";q=600.

RateLimit

Requests left in the current window and the seconds until it resets (IETF draft), e.g. "tier";r=597;t=42.

X-RateLimit-Limit

The tier's request quota of the current window.

X-RateLimit-Remaining

Requests left in the current window.

X-RateLimit-Reset

When the current window resets, Unix seconds.

Status codes

200 · 304 · 400 · 401 · 402 · 403 · 404 · 429 · 500 · 502 · 503

304 Not Modified: the If-None-Match validator still matches; no body.

Error codes

The codes this endpoint can return. Each links to what it means and what to do.

From the API's published specification, version 1.165.0.