One hotkey: owner, subnets, prune standing, emission
https://api.bittensor.ai/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 beforeto_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_30dis the 30 days ending at D, valued at D's close (meta.to_day,meta.emission_price_height), anddailyends at D; final or refused, never an earlier day (a day not available yet is a 503NOT_READY, one whose close is not followed by an indexed block a 503NOT_FINAL; a D before the first day of emission history a 400INVALID_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 endsdailyonly (emission_30dthe head's;meta.emission_price_heightabsent). Today, or omitted: the head'semission_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_30dandstaking_options(option Aroot_stakeand option Bfund, two blocks never combined).subnetsadds the per-subnet detail:known,swaps,subnets,totalsand 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):childkeysadds the top-levelchildkeys(children, parents and pending child set on every subnet) and eachsubnets[]row'sparents/children(pending_childrenis always there);staking_optionsadds (withsubnets)staking_options.subnets, option C: one pool row per subnet the hotkey has stake on, ranked by its 7-day APY, never averaged (root_stakeandfundare always there).dailyadds the same detail plus the per-day rowsdaily(each with its realized credits, the income figure, and its root claimable apart;total_*is a flow of every credit, never income) andchildkey_daily(null withsubnetsalone).daily/childkey_dailyare ONE row per day across the hotkey's subnets (spot sums at each subnet's day close;netuidand the alpha members null;subnets/unpriced_subnetssay what the sums cover) unlessdaily_netuidnames a subnet, and the per-subnetsubnetsdetail is computed only forinclude=subnets([]withdailyalone).basketadds each item'sbasket, the fund it runs asGET /baskets/{hotkey}'sdataat the latest available day end (null for a hotkey that runs no fund), andmeta.sections.basket(that read's meta); at most 20 hotkeys with it (more is a 400BATCH_TOO_LARGE).basket_holdingsimpliesbasketand adds each fund'sholdings_by_subnetto itsbasket(asGET /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 withoutbasketbeside it).namesadds the top-levelincluded.names: every distinct account on the page (accounts indataat 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 400INVALID_INCLUDE.- daily_netuidquery· integer · 0 to 65535
With
include=daily: servedaily/childkey_dailyas this subnet's rows (one per day, alpha members andnetuidset,subnets1) instead of one row per day across subnets. Withoutinclude=dailya 400INVALID_FILTER; outside 0..65535 a 400INVALID_NETUID. Omitted: the aggregated rows.- netuidsquery· string
With
include=subnetsorinclude=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[]andstaking_options.subnets[]keep only their rows on those subnets, andswaps[]keeps the whole-hotkey swaps (netuidnull) and the per-subnet swaps on them. A subnet the hotkey has no row on is simply absent. Every hotkey-level member,totalsand thedailyrows still describe the whole hotkey (usedaily_netuidfor one subnet's daily rows). Omitted: every subnet. More than 64 subnets or anything else is a 400INVALID_NETUID; withoutinclude=subnetsorinclude=dailya 400INVALID_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 (decodedfalse).- 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 (decodedfalse).- 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 (decodedfalse).- 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_reasonsays 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 (decodedfalse).- 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 (decodedfalse).- 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 (decodedfalse).- 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
identityis 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_daywith 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_daywith 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_availableinstead. - 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. Thesort=emission_30dkey. 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_takealone 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 insideother_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 oftotal_spot_tao_raoor 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 (intake_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_raoinstead.
- stakingobject · can be null
For a fund validator, the staking figures as
/basketsrows serve them (APY at the reference stake, realised nominator APY, swap costs, breakeven): the top-level figures over every pool, root included;subnet_onlyover 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_windowagainst 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_raowould 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 withunavailable_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 asapy_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_reasonno_yield).- Format: decimal number, as a string · can be negative
- 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
poolswithout 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 withunavailable_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-levelreference_stake_tao_rao. 8 decimals. Null withunavailable_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, withunavailable_reason, or when that APR is not above 0 (no_yield).- Format: decimal number, as a string · can be negative
- knownboolean
Whether the chain has ever stored a key for this hotkey (any storage item, at any time). False = never seen:
subnetsand every other list are[](GET /hotkeys/{hotkey}answers such a hotkey with a 404HOTKEY_NOT_FOUND; the list and batch forms keep its item). True withsubnets[]= a known hotkey registered nowhere atmeta.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_defaulttrue). Never null for a missing Delegates entry on an answer carryingtake_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_ratiois 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_positionscounts per pool). For a validator candidate the directory's count (GET /validators'meta.nominator_wallets_at, refreshed about every 10 minutes), else counted atmeta.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_positionsis 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_walletsis the exact count). Null exactly whennominator_positions_valuedis.- 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 ownas_of_day/as_of_height(stored once per accrual day). Served beside the legacystaking, 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.0when 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 whenapy_7dis (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 whenapy_30dis.- 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_dayof 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 againsthas_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.- 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'sn_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_optionsbesideinclude=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), byapy_7d.valuedescending (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_heightfor the first block. The subnet's current life.- life_start_heightinteger · unit block · can be null
The first block of the life
generationnames (GET /subnets/generations'start_height): use it, nevergeneration, for heights, ages and dates. Null exactly whengenerationis null (root without a life, no subnet), or transiently when this API cannot read the lives. Root'sgeneration0 starts at 0.- is_current_lifeboolean · can be null
Whether
generationis the slot's current life (true) or an ended one, re-registered since (false). Null exactly whengenerationis null, or transiently when this API cannot read the lives. Root'sgeneration0 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_levelis 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):
L1when a reference sale of 10 alpha moves the price by less than 1 % and the alpha reserve holds at least 1,000 alpha;L2when it holds at least 1 alpha; elseL3(less than 1 alpha, an alpha reserve of 0 or a TAO reserve of 0 included: a thin pool,thin_poolinrisk.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, plusprice_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; flagstake_raised_30d,subtoken_disabledandthin_pool(added by this API exactly whenfv_levelisL3); window flagsno_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_takeoveron 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 frommeta.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_raox the subnet's spot price atmeta.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_raoin USD atmeta.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.atheight -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'schildkeys[]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'schildkeys[]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 wholestake_weightis null instead, which is distinct from a weight of 0.- 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,
basisroot_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_ranknull). 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 isnon_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_rankis 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) orroot_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_uidon a subnet (the older registration goes first, then the lower UID: the runtime's rule, so every rank is unique) orunspecifiedon root (the chain takes the first lowest stake in storage iteration order, which is not specified: tied members sharecandidate_rank, and when they tie for rank 1 none isreplaced_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_daytometa.to_day, by day then netuid ([]when none). Only withinclude=daily: null withinclude=subnetsalone (totalsstill 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 (
netuidand every alpha member null: alpha of different subnets does not add up; the*_spot_tao_raomembers are the sums);daily_netuidgives one subnet's rows instead (this shape per subnet,subnets1).- 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) andbasket_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_raothere).- by_type_spot_tao_raoobject · unit rao (÷1e9) · can be null
Aggregated rows: each component of
by_type_alpha_raoat its subnet's day-close spot, floored per subnet and summed over the priced subnets, rao of TAO (an open map, asby_type_alpha_rao).root_claimable_spot_tao_raois itsroot_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 whentotal_spot_tao_raois 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 ofnetuid: a flow total, never the validator's income (it includesroot_claimable_queued, accrued and unrealized, andbasket_flush_credit, a re-credit of claimable already counted). The income figure isrealized_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_raoat the subnet's price at the day's last credit (1:1 on root), in rao of TAO: a flow total, never income (seerealized_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_subnetscounts 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_raoat 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) andbasket_flush_credit(a re-credit of claimable already counted): the income figure, in alpha rao ofnetuid. Exactlytotal_alpha_raoless 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_raoat the day's close price (1:1 on root), in rao of TAO. Null exactly whentotal_spot_tao_raois (an unpriced day), and on an older answer. On an aggregated row the sum over the priced subnets:total_spot_tao_raoless 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 ofnetuid: accrued, unrealized until claimed, never in an amount total. Null on an older answer, and on an aggregated row (root_claimable_spot_tao_raothere).- Format: whole number, as a string · on chain: u64
- childkeysarray of objects · optional
Only with
include=childkeysbeside 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 thatsubnets[]entry'schildren/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 withinclude=subnetsalone, 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 inmeta.childkey_missing_daysisn'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 (
netuidand every alpha member null: alpha of different subnets does not add up; the*_spot_tao_raomembers are the sums);daily_netuidgives one subnet's rows instead (this shape per subnet,subnets1).- 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_raoat 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_raoat spot, astake_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_raoat spot, astake_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.
dailyandchildkey_dailysummed over the window.- basketobject · can be null
Only with
include=basket(absent otherwise): the fund this hotkey runs, exactly asGET /baskets/{hotkey}'sdataat the latest available day end (no sections); its day, coverage and version aremeta.sections.basket. Null when the hotkey runs no fund (a hotkey whosestaking_options.fundblock is set never has a nullbasket: checked). At most 20 hotkeys per request with it (400BATCH_TOO_LARGE). Withinclude=basket_holdings(which impliesbasket) it also carriesholdings_by_subnet, asGET /baskets/{hotkey}?include=holdings_by_subnetserves 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
modlprefix as text (e.g.subtensr,bt/cloan). Null whenkindisaccount.- 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).
- 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).- 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.- 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
- 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_pricingreturns.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_twrand 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_reasonis thennot_readyand 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_priceandvs_index_stake_ratioare null. Null while the day's pricing isn't available yet (asprovisional).- 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 withvs_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 withvs_index_unavailable_reason(orstaker_twr_defaulted).- Format: decimal number, as a string · can be negative
- 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
- 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
- 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
- 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
- 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_onlythe 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_windowagainst 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_raowould 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 withunavailable_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 asapy_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_reasonno_yield).- Format: decimal number, as a string · can be negative
- 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.
- 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_basketgate and turnover bucket at the state head (not the served day end): served only when noatis 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
- as_of_blockinteger · unit block
The state head the status 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).
- 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 anatis 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 ownas_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.0when 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 whenapy_7dis (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 whenapy_30dis.- 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_dayof 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 likeroot_stake, with its ownas_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 againsthas_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.- 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'sn_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_heightis 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 withfirst_funded_height.- seriesarray of objects · optional
Only with
include=series(absent otherwise): the fund's day ends of the 90 days ending atmeta.day(fewer near the first available day), oldest first; each with that day'spricing.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).
- 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).- 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.- 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
- 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.pricingfor 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 firstchild_limitholders atmeta.day, by owed units descending, asGET /baskets/{hotkey}/holders?day=<meta.day>&limit=<child_limit>answers them;meta.sections.holders.page.next_cursorcontinues 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_unitsvalued at the fund's NAV per unit (pre-claim / close anchors), floored, rao. Null withincome_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 newestchild_limitevents (BasketDeposited, BasketClaimed, BasketSwapped, BasketClaimDustSkipped, BasketStakedIn, BasketAlphaWrittenOff, BasketHoldingConverted) at the head, not the day end, asGET /baskets/{hotkey}/events?limit=<child_limit>answers them;meta.sections.events.page.next_cursorcontinues 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) orfinalization(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 theinitializationandfinalizationphases.- 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) orpost_dispatch(after it: the fee refund, TransactionFeePaid, System.ExtrinsicSuccess / ExtrinsicFailed). Null outside theextrinsicphase, 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_phasepre_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_phasenull) 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,_3when repeated), elsearg0,arg1. A field typedNetUidStorageIndexis alwaysnetuid_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 inmeta.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'serror.pallet. Carried by System.ExtrinsicFailed, Utility.BatchInterrupted / ItemFailed, and theErrresults of Proxy.ProxyExecuted, Multisig.MultisigExecuted, Sudo.Sudid / SudoAsDone, Utility.DispatchedAs and Scheduler.Dispatched. Null on every other event, on anOkresult, 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 aToken/Arithmetic/Transactionalerror (error_palletthen 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), slowpublic, max-age=300, stale-while-revalidate=600(state that moves in minutes or days) or tippublic, 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). Neverimmutable.no-storeon 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-revalidateandstale-if-error;no-storewithX-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, withX-BTAI-Stale-As-Of,Age(its seconds since then) andWarning: 110 - "Response is Stale", andCache-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.
- AMBIGUOUS_CREDENTIALS
- BAD_GATEWAY
- BATCH_TOO_EXPENSIVE
- BILLING_UNAVAILABLE
- BUDGET_EXCEEDED
- CONCURRENCY_LIMIT
- HOTKEY_NOT_FOUND
- INSUFFICIENT_PERMISSIONS
- INTERNAL_ERROR
- INVALID_ADDRESS
- INVALID_DAY
- INVALID_FILTER
- INVALID_INCLUDE
- INVALID_NETUID
- INVALID_RANGE
- NOT_FINAL
- NOT_READY
- PAYMENT_REQUIRED
- PLAN_REQUIRED
- RANGE_TOO_LARGE
- RATE_LIMITED
- REPEATED_PARAMETER
- SERVICE_UNAVAILABLE
- SOURCE_BUSY
- SOURCE_NOT_READY
- SOURCE_TIMEOUT
- UNAUTHORIZED
- UNKNOWN_PARAMETER
- VALIDATION_ERROR
From the API's published specification, version 1.165.0.