Skip to content
TAO$188.21
BTC0.002927
MCap$2.22B
Vol$86.25M

API reference / Subnets

One life of a subnet slot: its window, holders, emissions, revenue, hyperparameters, metagraph, repository

GET/api/v2/subnets/{netuid}/generations/{generation}
Status
Beta
Auth
API key or OAuth access token
Scope
data:read
Rate limit
plan

Everything about ONE life (generation) of a netuid slot in one call, any life, the current one included: a re-registered slot is a new subnet, and an ended life's page reads its own data here, never the current life's.

Full description

Everything about ONE life (generation) of a netuid slot in one call, any life, the current one included: a re-registered slot is a new subnet, and an ended life's page reads its own data here, never the current life's. data.life is the life as GET /api/v2/subnets/generations serves it; data.window its blocks (start_height .. end_height, exclusive; last_height, the head for the current life), its UTC days (first_day .. last_day) and the days served (served_from_day .. served_to_day: from_day / to_day, default the life's last 90 days, at most 366 a call; served_complete when they are the whole life; the whole ones among them first_whole_day .. last_whole_day). Every section serves the named life only, each row exactly its own route's row. On the served days: holders_daily (holders per day end), emission_share (per UTC day, partial on an edge day), revenue (per whole UTC day), net_emission (1 / 7 / 30-day windows ending at the last served whole day) and marks (the chart marks, /marks' data). Over the whole life: emissions (the newest 25 credited blocks, more, and the whole life's totals), hyperparam_changes (the newest 50, more), metagraph (the life's last snapshot day: per-UID permits, consensus, incentive, dividends, trust and emission; no stake or axon, which are live state) and stake_yields (on request only: include=stake_yields, never in the default; every pool at the life's last available day, at amount_rao; without it, at_amount_omitted and no at-amount member; without the picker's figures priced at the head: exit null, breakeven unknown). repo is bittensor.ai's own GitHub content for the life, exactly GET /api/v2/subnets/{netuid}/repo?generation=<generation>'s data; profile the life's kept subnet page (the owner's published profile) and chain logo (null with no_page when it kept neither); include=page and data.page are its deprecated spellings, still served together with it. A section included but empty for the life is present: empty arrays, or null with why in data.unavailable_reasons ({reason, detail} per section; {} when none: e.g. metagraph no_snapshot_in_life, a section whose own route answered an error its code). generation is the life's id (GET /api/v2/subnets/generations' generation) or its start_height; meta.generation and data.life.generation are the canonical id. One data-source read for the slot's lives (an unknown life is a 404 before the summary is read), one for the summary. Cached: the current life 5 minutes (its sections move by the day or the tempo); an ended life 5 minutes, or 1 hour once the data source states it settled (meta.settled; settled for a day at the edge when no repo / page is included, whose content bittensor.ai can still update). Errors are application/problem+json: INVALID_NETUID, INVALID_GENERATION (400: not an integer >= 0), INVALID_INCLUDE, INVALID_AMOUNT, INVALID_DAY, INVALID_RANGE (400: from_day after to_day, more than 366 days, or no day of the life), UNKNOWN_PARAMETER, SUBNET_NOT_FOUND (404: the slot was never registered), GENERATION_NOT_FOUND (404: the slot never had that life), NOT_READY (503: the lives registry does not reach genesis yet), SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503: also while the data source does not serve the summary yet).

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

Path parameters

netuidpath, required· integer · 0 to 65535

Subnet slot (0 = root).

generationpath, required· integer · 0 to 9223372036854776000

The life: its generation as GET /api/v2/subnets/generations names it (the stored registration id), or its start_height; the id is matched first. Not an integer >= 0: a 400 INVALID_GENERATION; neither of a life of the slot: a 404 GENERATION_NOT_FOUND.

Query parameters

includequery· string

A comma list (repeatable) of the sections to serve: holders_daily, emissions, emission_share, revenue, net_emission, hyperparam_changes, marks, metagraph, stake_yields, repo, profile, page. Omitted: every section but stake_yields (on request only: include=stake_yields). Anything else is a 400 INVALID_INCLUDE.

amount_raoquery· string

The TAO stake_yields quotes each pool at, a decimal integer 1..1000000000000000000 in rao (as on GET /api/v2/subnets/{netuid}/stake-yields). Omitted: the rows carry no at-amount member (at_amount_omitted). Anything else is a 400 INVALID_AMOUNT.

from_dayquery· string (date)

The first UTC day (YYYY-MM-DD) the day sections and marks serve; before the life's first day it is that day. Omitted: the first of the 90 days ending at to_day. Not a day: a 400 INVALID_DAY; after to_day, or more than 366 days before it: a 400 INVALID_RANGE.

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

The last UTC day they serve; after the life's last day it is that day. Omitted: the life's last day (window.last_day). Not a day: a 400 INVALID_DAY; a day before the life (no day served): a 400 INVALID_RANGE from the data source.

Format: date, YYYY-MM-DD

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 life, its window and the sections asked for.

lifeobject

The life, as GET /subnets/generations serves it, its logo our copy of the image.

19 fields in life
netuidinteger · unit id

The subnet slot this life occupied (0 = root).

generation_indexinteger · unit count

Which life this is for its netuid slot, counting up by start height: 1 for the slot's first registration, 2 for the next, and so on (at least 1). A label next to generation, which stays the id.

generationinteger · unit id

Opaque life id (the life's registration identifier), NOT a block height; use life_start_height for the first block. This life's id. Candles and pools are keyed on it, and it is the generation of /subnets/{netuid}/candles. Often equal to start_height, but runtime v133 set the key retroactively, so a life alive then has an id later than its start_height (SN1: 1,497,824 for a life that began at 172,898); a life that ended before v133 without one uses its start_height.

life_start_heightinteger · unit block · can be null

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

is_current_lifeboolean · can be null

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

is_currentboolean

True for the life occupying the slot now (no end_height); at most one per netuid.

start_heightinteger · unit block

The life's first block: its NetworkAdded block (the registration).

start_timestring (date-time) · can be null

Timestamp of start_height, RFC 3339 UTC. Null when that block's time is not known.

Format: date and time, ISO 8601 in UTC
end_heightinteger · unit block · can be null

The block that ended the life, exclusive (the life's last block is end_height - 1): its NetworkRemoved block; with no removal on record, the next registration's block. Null while current. A removed life ends at its removal, not at the next registration: the gap up to the next life's start_height is the slot's empty period.

end_timestring (date-time) · can be null

Timestamp of end_height, RFC 3339 UTC. Null while current.

Format: date and time, ISO 8601 in UTC
end_reasonstring · can be null

Why the life ended. removed: a NetworkRemoved event, or a same-block kill of the slot's NetworkRegisteredAt key before a re-registration in that block. superseded: the next registration ended it with no removal on record, which can happen only before runtime v133 (block 1,404,224), before the key existed; netuid 21's first life is the likely case. Null while current. New values may be added; treat unknown values as unavailable.

first_emission_heightinteger · unit block · can be null

FirstEmissionBlockNumber as stored during this life: the block its emission started. Null if it never started in this life.

owner_at_startstring · can be null

The subnet owner coldkey (SubtensorModule.SubnetOwner) at start_height, SS58 (prefix 42; the source's 0x + 64 hex, rendered). Null without an entry.

Format: SS58 address
owner_at_endstring · can be null

The life's last subnet owner coldkey (the current owner for the current life), SS58 (prefix 42; the source's 0x + 64 hex, rendered). Differs from owner_at_start when ownership moved during the life. Null without an entry.

Format: SS58 address
registration_lock_tao_raostring · unit rao (÷1e9) · can be null

SubnetLocked at the life's start: the TAO locked to register it, in rao of TAO. Null when not recorded.

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

The identity the life last carried: the newest one set inside it (as_of_height says when), its logo_url our copy of the image. Null if it never had one.

9 fields in identity_at_end
as_of_heightinteger · unit block

The block this identity was set at: the newest identity set inside the life.

namestring · can be null

The subnet's name (SubnetIdentitiesV3.subnet_name) as set at as_of_height; null when unset (empty).

urlstring · can be null

The subnet's website (SubnetIdentitiesV3.subnet_url) as set at as_of_height; null when unset (empty).

githubstring · can be null

The subnet's GitHub repository (SubnetIdentitiesV3.github_repo) as set at as_of_height; null when unset (empty).

discordstring · can be null

The subnet's Discord (SubnetIdentitiesV3.discord) as set at as_of_height; null when unset (empty).

descriptionstring · can be null

The subnet's description (SubnetIdentitiesV3.description) as set at as_of_height; null when unset (empty).

logo_urlstring · can be null

The life's logo (the image SubnetIdentitiesV3.logo_url named at as_of_height): 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: logo_url_unavailable_reason says why.

symbolstring · can be null

The token symbol (SubtensorModule.TokenSymbol) the life last carried. Null when unknown, and on an older data version's answer.

logo_url_unavailable_reasonstring · can be null

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

symbol_at_endstring · can be null

The token symbol (SubtensorModule.TokenSymbol) the life last carried, on its own: the same value as identity_at_end.symbol, and also there for a life that never had a subnet identity (identity_at_end null). Null when never set or not known yet, and on an older data version's answer that does not carry it.

is_end_exactboolean · can be null

Whether end_height is the recorded end. True: the chain recorded the removal (end_reason removed). False: superseded, so end_height is the next registration's block, an upper bound on the end. Null while current, and on an older data version's answer (unknown there).

owner_changesarray of objects · optional

With include=owner_changes only (absent otherwise; it needs netuid): every change of the subnet owner coldkey (SubnetOwner) or owner hotkey (SubnetOwnerHotkey) inside the life after its registration, from the storage history whatever the cause, oldest first. Empty when ownership never moved.

5 fields in owner_changes (each item)
kindstring

coldkey: the owner coldkey (SubnetOwner) changed; hotkey: the owner hotkey (SubnetOwnerHotkey). New values may be added; show an unknown value as is (or generically).

heightinteger · unit block

The block the new value was written in.

timestring (date-time) · can be null

That block's time, RFC 3339 UTC. Null when not recorded.

Format: date and time, ISO 8601 in UTC
fromstring · can be null

The value before the change, SS58 (prefix 42; the source's 0x + 64 hex, rendered). Null without a previous entry.

Format: SS58 address
tostring · can be null

The value after the change, SS58 (prefix 42). Null when the entry was removed.

Format: SS58 address
windowobject

The life's blocks and days: every section is inside them.

10 fields in window
start_heightinteger · unit block

The life's first block (its registration).

end_heightinteger · unit block · can be null

The block that ended the life, exclusive (the removal block or the next life's first block). Null while current.

last_heightinteger · unit block

The life's last block served: end_height - 1, or the head for the current life.

first_daystring (date)

The UTC day of the life's first block.

Format: date, YYYY-MM-DD
last_daystring (date)

The UTC day of last_height (today for the current life).

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

The first SERVED UTC day the life holds whole (every block of it inside the life). Null, with last_whole_day, when the served days hold no whole day.

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

The last served UTC day the life holds whole (for the current life at most the last closed day). Null with first_whole_day.

Format: date, YYYY-MM-DD
served_from_daystring (date)

The first UTC day the day sections (holders_daily, emission_share, revenue, net_emission) and marks serve: from_day, else the first of the life's last 90 days; never before first_day.

Format: date, YYYY-MM-DD
served_to_daystring (date)

The last UTC day they serve: to_day, else last_day; never after last_day.

Format: date, YYYY-MM-DD
served_completeboolean

True when the served days are the whole life (first_day .. last_day); false: page with from_day / to_day (at most 366 days a call) for the rest.

holders_dailyobject · can be null

include=holders_daily: holders per served day end. Null when its data could not be served for the life, with why in unavailable_reasons.

1 field in holders_daily
pointsarray of objects

One per served UTC day whose last block is inside the life (never another life's snapshot), oldest first; the days of GET /subnets/{netuid}/holders/daily. delegate_count may be null on any day (the nominator count is not available for it). [] when no day is available.

11 fields in points (each item)
daystring (date)

The UTC day.

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

The day's last block: every figure is read there.

holder_countinteger · unit count

Coldkeys with alpha > 0 on the subnet (each counted once).

delegate_countinteger · unit count · can be null

The nominator count: hotkeys whose pool on the subnet holds a non-zero share from a coldkey other than the hotkey's Owner (the validators other people delegate to; the subnet list's delegates), at the day's end. Null on a day before meta.delegate_count_from_day (each pool's Owner is not recorded for those days; every day when that is null), never a 0 standing in. On an older data version's answer: hotkeys with at least one staker. Either way null, with position_count and max_position_alpha_rao, when the pools' day-end stakers cannot be whole (fewer positions than holders) or disagree with the holders (the largest position above top10_alpha_rao).

position_countinteger · unit count · can be null

(hotkey, coldkey) positions with alpha > 0 (at least holder_count). Null when the pools' day-end stakers cannot be whole (fewer positions than holders) or disagree with the holders (the largest position above top10_alpha_rao).

total_alpha_raostring · unit alpha_rao (÷1e9)

The holders' alpha together, alpha rao.

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

The largest single (hotkey, coldkey) position, alpha rao (at most top10_alpha_rao). Null with position_count.

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

The 10 largest coldkeys' alpha together, alpha rao (at most total_alpha_rao).

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

The fewest coldkeys holding more than half the alpha (0 without a holder; at most 10 exactly when top10_alpha_rao is more than half, checked).

hhi_ratiostring · unit ratio · 8 decimals · can be null

Normalised Herfindahl-Hirschman index over the coldkeys' alpha, 0..1, 8 decimals (0 = spread evenly, 1 = one holder). Null when the source has none.

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

UIDs holding a validator permit at the day's end. Null while the day's neuron data isn't available yet.

emissionsobject · can be null

include=emissions: the emission log and the whole life's totals. Null when its data could not be served for the life, with why in unavailable_reasons.

3 fields in emissions
rowsarray of objects

The life's newest blocks that credited the subnet (up to 25), strictly newest first: the rows of GET /subnets/{netuid}/emissions. [] when none.

8 fields in rows (each item)
heightinteger · unit block

The block (an epoch of the subnet, or a flush).

timestring (date-time) · can be null

The block's timestamp, RFC 3339 UTC. Null when not known.

Format: date and time, ISO 8601 in UTC
alpha_raostring · unit alpha_rao (÷1e9)

The block's REALIZED credits, alpha rao: every component of by_component_alpha_rao except the root claimable (root_claimable_*: accrued until a staker claims it, never in an amount total) and the basket flush credit (it re-credits claimable already counted). Checked equal to those components summed.

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

The root claimable the block queued (the root_claimable_* components summed, checked), alpha rao: accrued, not realized, so never in alpha_rao or tao_value_rao. 0 when none.

Format: whole number, as a string · on chain: u64
by_component_alpha_raoobject

Alpha per emission component, an open map (owner_cut, miner_incentive, validator_take, nominator_dividend, root_take, root_claimable_queued, basket_flush_credit, ...; a new component can appear), alpha rao strings. The breakdown, every component in it: not a total.

creditsinteger · unit count

The credits (one per recipient and component) the block wrote.

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

The runtime's alpha price at the block, rao of TAO per alpha (root: 1,000,000,000). Null when the pool has no price there.

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

alpha_rao (realized) at the runtime's exact alpha price at the block, floored once, rao of TAO: the credits at the price of their block. price_rao_per_alpha shows that price to the whole rao, so this is at least alpha_rao x price_rao_per_alpha / 1e9 (floored) and less than 1 rao per whole alpha above it (root: exactly alpha_rao). Null exactly when the price is.

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

True when the life has older credited blocks: page on with GET /subnets/{netuid}/emissions?to_height=<the last row's height - 1>&generation=<this life>.

totalsobject

The whole life's credits (every block, not only the rows); the rows summed when not more.

3 fields in totals
alpha_raostring · unit alpha_rao (÷1e9)

Every REALIZED credit of the life, alpha rao: the components but the root claimable and the basket flush (checked equal to them).

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

The root claimable the life queued (the root_claimable_* components, checked), alpha rao: accrued, never in alpha_rao.

Format: whole number, as a string · on chain: u64
by_component_alpha_raoobject

Alpha per emission component over the life, an open map (a new component can appear), alpha rao strings.

emission_shareobject · can be null

include=emission_share: the share of the network's TAO emission per day. Null when its data could not be served for the life, with why in unavailable_reasons.

1 field in emission_share
daysarray of objects

Every available UTC day holding a block of the life inside the served days (window.served_from_day .. served_to_day), oldest first: the whole days as the route serves them, an edge day from the life's own blocks (partial). [] when none.

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

The UTC day.

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

The day's last block the figures are summed through.

tao_in_raostring · unit rao (÷1e9)

SubtensorModule.SubnetTaoInEmission summed over the UTC day: TAO emitted into the pool, rao.

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

The same summed over every subnet that day, rao. Null on a day the network total is not available: today so far (the current life's last day, partial) and days before dTAO.

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

tao_in_rao / network_tao_in_rao, a ratio 0..1 with 8 decimals. Null when the network total is 0.

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

The subnet's rank by tao_in_rao that day (1 = the largest; ties share). Null on an edge day (partial): the life's part of a day is not ranked.

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

The day's whole TAO block emission to subnets: every subnet's injected TAO plus the chain's excess buy (SubtensorModule.SubnetExcessTao), per block, rao. Null while the day's protocol flows aren't available yet, and on an older data version's answer.

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

The subnet's (injected TAO + excess buy) / network_block_emission_tao_rao, a ratio 0..1 with 8 decimals: its share of the whole block emission (share_ratio is its share of the injected TAO only). Null with network_block_emission_tao_rao.

Format: decimal number, as a string
partialboolean

True on an edge day of the life (it starts or ends inside the day, or the current life's day in progress): the day's sums cover only the life's blocks. False on a whole day of the life (window.first_whole_day .. window.last_whole_day).

revenueobject · can be null

include=revenue: the owner's revenue per day. Null when its data could not be served for the life, with why in unavailable_reasons.

1 field in revenue
daysarray of objects

Every available whole UTC day of the life inside the served days (window.served_from_day .. served_to_day), oldest first. [] when none (and on root).

11 fields in days (each item)
daystring (date)

The UTC day.

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

The day's last block the figures are summed through.

owner_cut_alpha_raostring · unit alpha_rao (÷1e9)

The owner_cut emission component credited that day: the owner's revenue, alpha rao.

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

owner_cut_alpha_rao at the day's close price (close_price_tao), rao. Null without a price.

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

validator_take + nominator_dividend credited to the subnet's CURRENT owner hotkey (meta.owner_hotkey) that day, alpha rao: what the owner earns as a validator. Separate from revenue, never added to it; a past day counts the current owner hotkey, not the one that day.

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

owner_validator_dividends_alpha_rao at the day's close price, rao. Null without a price.

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

SubtensorModule.RAORecycledForRegistration's increases that day: TAO recycled by neuron registrations, rao. Null where the supply counters do not cover the day (never a partial sum).

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

SubtensorModule.AlphaRecycled's increases that day, alpha rao. Null as recycled_registration_tao_rao.

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

The pool's price at the day's end block, TAO per alpha, 9 decimals. Null without a pool state.

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

The alpha the day's epochs drained (server + validator + root + the pending owner cut, withheld miner incentive included), alpha rao: the base the chain splits the owner cut from (owner_cut = SubnetOwnerCut, 11796 / 65535, of it per epoch). Excludes the alpha injected into the pool. Null when the day starts before the drain report (the first available day has no previous day end: unknown, never 0), and on a older data version's answer.

Format: whole number, as a string · on chain: u64
partialboolean

Always false: only the life's whole days are served (an edge day's stored day mixes two lives).

net_emissionobject · can be null

include=net_emission: alpha emitted, burned, recycled and net. Null when its data could not be served for the life, with why in unavailable_reasons.

1 field in net_emission
windowsarray of objects

The 1, 7 and 30-day windows (shortest first) ending at the last served whole day (window.last_whole_day), each floored at the life's first whole day (floored_at_life). [] when the served days hold no whole day, and on root.

14 fields in windows (each item)
window_daysinteger · unit days

The window's length in UTC days (one of windows).

from_daystring (date) · can be null

The window's first UTC day. Null (with to_day) when the window holds no day of the subnet's current life (a subnet registered today): floored_at_life true, days_available 0, every figure null.

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

The window's last UTC day (meta.last_day). Null with from_day when the window holds no day of the subnet's current life.

Format: date, YYYY-MM-DD
days_availableinteger · unit count · optional

How many of the window's days are available.

days_builtinteger · unit count · deprecated

How many of the window's days are available. Deprecated: use days_available; sunset 2027-02-15.

Deprecated since 2026-10-17, removed after 2027-02-15. Use days_available instead.
completeboolean

True when every day of the window is available and the supply counters cover it. A false window's figures are a lower bound (missing days), or null where the counters do not cover it.

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

ALL alpha issued on the subnet in the window: emitted_participants_alpha_rao + injected_alpha_rao, alpha rao. Null with injected_alpha_rao (a total that leaves the injection out is never served; an older data version's answer has no injection, so it is null there).

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

Alpha the window's epochs drained to participants (server + validator + root + the owner cut), alpha rao. The credited components of emitted_by_component_alpha_rao sum to at most it: incentive withheld from an owner / immune miner is burned or recycled, never credited. Null below the epoch-drain floor (unknown, never 0); the totals computed from it are null too and complete is false.

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

Alpha injected into the subnet's pool (SubtensorModule.SubnetAlphaInEmission, per block) in the window, alpha rao. Null while the window's protocol flows aren't available yet, and on an older data version's answer.

Format: whole number, as a string · on chain: u64
emitted_by_component_alpha_raoobject

emitted_participants_alpha_rao split by component, alpha rao: miner_incentive, nominator_dividend, validator_take, owner_cut, root_take, root_claimable_queued, basket_flush_credit, ... Clients must accept components not documented yet.

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

SubtensorModule.AlphaBurned's increases in the window, alpha rao. Null when the supply counters do not cover the window (never a partial sum).

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

SubtensorModule.AlphaRecycled's increases in the window, alpha rao. Null as burned_alpha_rao.

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

emitted_alpha_rao (all issuance) - burned_alpha_rao - recycled_alpha_rao, alpha rao (may be negative). Null when any of those is null.

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

True when the window starts at the subnet's current life's first whole day (meta.life_first_day) instead of window_days back: a younger life serves its days so far (complete false; burned / recycled are the life's). Null on an older data version's answer, whose windows could reach into the previous life.

hyperparam_changesobject · can be null

include=hyperparam_changes: the newest hyperparameter changes. Null when its data could not be served for the life, with why in unavailable_reasons.

2 fields in hyperparam_changes
rowsarray of objects

Up to 50 changes inside the life, newest first: the rows of GET /subnets/{netuid}/hyperparam-changes. [] when none.

16 fields in rows (each item)
idstring · unit id

{height}-{seq}: the change's id (the extrinsic's last write to the key).

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

The block of the change.

timestring (date-time) · can be null

The block's time (RFC 3339 UTC).

Format: date and time, ISO 8601 in UTC
extrinsic_idstring · unit id · can be null

The extrinsic that made it, {height}-{index} (/api/v2/extrinsics/{id}). Null on a hook change, which no extrinsic makes.

Format: block and index, such as 4200000-3
itemstring

The SubtensorModule storage item written: the hyperparameter's storage name (Tempo, Kappa, MaxAllowedUids, ...). Burn and Difficulty are never listed: the runtime moves them itself on every registration and adjustment, so they are not owner or sudo changes.

value_beforevalue

The value before the change, decoded with the metadata in force at height (a number, boolean, string or object, as the item's type decodes); the item's storage default when the key did not exist (value_before_defaulted).

value_before_defaultedboolean

True when the key did not exist before: value_before is the item's storage default.

value_aftervalue

The value written, decoded as value_before. Null when removed.

removedboolean

True when the change removed the key (the item falls back to its default).

value_before_rawstring · unit id · can be null

value_before as stored, SCALE 0x hex. Null when the key did not exist.

Format: hex: 0x and hex digits
value_after_rawstring · unit id · can be null

value_after as stored, SCALE 0x hex. Null when removed.

Format: hex: 0x and hex digits
originstring · can be null

Who made the change: sudo (the AdminUtils call ran with a Root origin, Sudo.sudo), owner (a signed AdminUtils call: the subnet owner, the runtime refuses anyone else), other (no AdminUtils call in the extrinsic, e.g. register_network seeding a new subnet), hook (no extrinsic: the chain itself, at the end of a block: call dissolution_cleanup when a dissolved subnet's freed slot is reset, then network_registration when a queued registration sets the new subnet's initial parameters). Null when the extrinsic has no call row. Clients must accept values not documented yet. New values may be added; show an unknown value as is (or generically).

callstring · can be null

The Pallet.call that made the change: the extrinsic's innermost AdminUtils call, else its top-level call; dissolution_cleanup or network_registration for a hook change. Null with origin.

call_idstring · can be null

That call's id (/api/v2/calls/{id}). Null with call.

signerstring · can be null

The extrinsic's signer, SS58. Null for an unsigned extrinsic and on an older data version's answer.

Format: SS58 address
categoryenum · can be null

The parameter's family. Null on an older data version's answer. Clients must accept values not documented yet.

One of: consensus, weights, registration, emission, owner, network, other
moreboolean

True when the life has older changes: page on with GET /subnets/{netuid}/hyperparam-changes (from_height = window.start_height, to_height = the last row's height - 1).

marksobject · can be null

include=marks: the chart marks on the served days. Null when its data could not be served for the life, with why in unavailable_reasons.

1 field in marks
marksobject

The marks inside the life's blocks on the served days (window.served_from_day .. served_to_day), by source: the data of GET /subnets/{netuid}/marks (events, whale trades, liquidity changes; each oldest first).

3 fields in marks
eventsarray of objects

Chain events (every *-registration / *-change / runtime-upgrade kind asked for).

tradesarray of objects

Whale trades (whale-trade; always [] on the TAO chart).

liquidityarray of objects

Liquidity changes (liquidity-event; always [] on the TAO chart).

metagraphobject · can be null

include=metagraph: the last snapshot day. Null (no_snapshot_in_life) when no day end is inside the life.

3 fields in metagraph
daystring (date)

The snapshot's UTC day: the life's last day whose end is inside it.

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

That day's last block, where every value is read.

neuronsarray of objects

One per UID, ascending.

9 fields in neurons (each item)
uidinteger · unit id

The neuron's UID on the subnet.

hotkeyobject · can be null

The UID's hotkey, both encodings. Null without an entry.

activeboolean · can be null

SubtensorModule.Active[uid] that day. Null without an entry.

validator_permitboolean · can be null

SubtensorModule.ValidatorPermit[uid] that day. Null without an entry.

consensus_ratiostring · unit ratio · 6 decimals · can be null

Consensus[uid] (u16 / 65535), a ratio 0..1. Null without an entry.

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

Incentive[uid] (u16 / 65535), a ratio 0..1. Null without an entry.

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

Dividends[uid] (u16 / 65535), a ratio 0..1. Null without an entry.

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

ValidatorTrust[uid] (u16 / 65535), a ratio 0..1. Null without an entry.

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

The UID's emission that day, alpha rao.

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

include=stake_yields: the pools at the life's last available day. Null (no_built_day_in_life) when no day was available in an ended life.

14 fields in stake_yields
optionenum

subnet_stake (netuid >= 1) or root_stake (netuid 0): every row is that option.

One of: subnet_stake, root_stake
netuidinteger · unit id

The subnet slot.

generationinteger · unit id · can be null

Opaque life id (the life's registration identifier), NOT a block height; use life_start_height for the first block. This life. Null on root.

life_start_heightinteger · unit block · can be null

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

is_current_lifeboolean · can be null

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

daystring (date) · can be null

The life's last available day the legacy members are read at. Null when none.

Format: date, YYYY-MM-DD
amount_tao_raostring · unit rao (÷1e9) · can be null

The TAO the rows are quoted at, rao: the request's amount_rao. Null without it (at_amount_omitted).

Format: whole number, as a string · on chain: u64
at_amount_omittedboolean

True when no amount_rao was asked: the rows carry the pools' own members only, every at-amount member null (at_amount, stake_alpha_rao, multiplier, stake_tier, the *_at_amount_ratio rates; a root row's accrual.at_amount is quoted at 1 TAO). False when quoted at amount_rao.

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

The subnet's alpha spot at that day end, rao of TAO per 1 alpha. Null without one.

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

SubnetTAO, the pool's depth, rao. Null on root.

Format: whole number, as a string · on chain: u64
orderenum

The rows' order (the default: apy_at_amount).

One of: apy_at_amount, tao_apr_at_amount, breakeven_days, pool_stake, take, root_stake
direnum

The order's direction, asc or desc; nulls last either way.

One of: asc, desc
subnet_stake_weightstring · unit alpha_rao (÷1e9) · can be null

S, alpha-equivalent rao: the subnet's epoch stake weight summed. Null before the subnet's first epoch.

Format: decimal number, as a string
rowsarray of objects

Every pool, in order / dir: the rows of GET /subnets/{netuid}/stake-yields, without this API's figures priced at the head (a past life's pool is not the pool now): exit is null and at_amount.breakeven_state unknown. An ended life's rows are its stored day's: the option members (pool, at_amount, risk...) are null.

35 fields in rows (each item)
hotkeystring

The validator hotkey, SS58 (prefix 42).

Format: SS58 address
stake_alpha_raostring · unit alpha_rao (÷1e9) · can be null

X: the amount in the pool's alpha at the day-end spot (root: TAO 1:1), floored. Null without a spot.

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

The pool's alpha spot at its window's open (the day end inputs.days days before), rao of TAO per 1 alpha (per 1e9 alpha rao), floor(price x 1e9): the runtime price truncated to a whole rao (root 1e9). Null without one.

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

The dilution model: root, all_to_children or standard. Null on a row whose pool has no figures for data.day (a pool newer than that day: these per-day members are null too). New values may be added; show an unknown value as is (or generically).

inputsobject · can be null

The pool's model inputs. Null with model.

multiplierstring · unit ratio · 12 decimals · can be null

M: the stake's dilution of the per-share return, 12 decimals. Null with pool_unpriced, not_ready or pool_refused.

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

low when the pool's own stake A is below X, else normal. Null without X. New values may be added; show an unknown value as is (or generically).

nominator_apy_ratiostring · unit ratio · 8 decimals · can be null

(1 + y)^(365 / days) - 1: the pool's APY before the stake.

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

(1 + y M)^(365 / days) - 1: the stake's APY after joining.

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

y M x 365 / days: the stake's APR (a breakeven's rate: round-trip cost / (this / 365)).

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

TAO terms before the stake: ((1 + y) x spot / window-open spot - 1) x 365 / days.

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

TAO terms at the amount: ((1 + y M) x spot / window-open spot)^(365 / days) - 1.

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

TAO terms at the amount: ((1 + y M) x spot / window-open spot - 1) x 365 / days.

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

Why rates are null: pool_refused (the pool's return over the window is not rated: no share-index history, a format change, ...; every rate null), parent_set_unknown (the pool carries material childkey take, so its yield is rated over 1 day only until its per-day parent sets are stored: every annualised rate null), window_too_short (the pool's window is shorter than its full window, 7 days or root's 30, a younger pool: every annualised rate null), pool_unpriced (no spot price or no own share for the multiplier: the pool's own rates stand, the stake's are null), not_ready (the day's stake weights are not available yet: as pool_unpriced, the pool's own rates stand, the stake's are null) or root_basis_pending (a root pool rated on its flat share price instead of the accrued root claimable: every rate null, never a 0 % APY). Null when every rate is given. New values may be added; treat unknown values as unavailable.

identity_namestring · can be null

The hotkey's identity name (its own, else its owner coldkey's). Null without one, and on an older data version's answer.

take_ratiostring · unit ratio · 6 decimals · can be null

The hotkey's Delegates take at the head, 0..1 (6 decimals); the take order's key. Null on an older answer.

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

Subnet rows: the effective childkey take here, max(stored, floor), 0..1. Null on root rows and on an older answer.

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

Subnet rows: a validator permit on the subnet now. Null on root rows and older answers.

consistently_activeboolean · can be null

Subnet rows: Active at every day end of the 7-day window. Null with no covered day, on root rows and on an older answer.

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

Subnet rows: TotalHotkeyAlpha now, the pool's size (the pool_stake order's key). Null on root rows and older answers.

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

Subnet rows: the pool at spot, rao of TAO. Null when unpriced, on root rows and older.

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

Subnet rows: coldkeys with a share in the pool. Null on root rows and older answers.

poolobject · can be null

Subnet rows: the pool's own 7-day rates (alpha APY, TAO APR, the price's change). Null on root rows and older answers.

at_amountobject · can be null

Subnet rows: the stake at the amount on the no-dilution bound, with its breakeven. An UPPER bound, never an expected yield. Null on root rows and older answers.

riskobject · can be null

Subnet rows: option C's risk (high; thin_pool added by this API when data.fv_level is L3). Null on root rows and older answers.

has_root_uidboolean · can be null

Root rows: the hotkey holds a root UID. Null on subnet rows and older answers.

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

Root rows: the hotkey's root stake (the root_stake order's key), rao. Null on subnet rows and older answers.

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

Root rows: option A's holder-true accrual and the amount's (an upper bound). Null on subnet rows and older answers.

sell_gate_7dobject · can be null

Root rows: the root-sell gate over the 7-day window. Null on subnet rows and older.

unclaimed_exposureobject · can be null

Root rows: the fund the accrual sits in (B's figures, never added to A's). Null when the hotkey runs no fund, on subnet rows and older answers.

risk_principalobject · can be null

Root rows: the principal's risk (low). Null on subnet rows and older answers.

risk_accrualobject · can be null

Root rows: the accrual's risk (medium). Null on subnet rows and older answers.

exitobject · can be null

Computed by this API: unstaking, instant to free TAO at data.cost's exit cost; no hold on a subnet, RootStakeUnlockInterval on root. Null on an older answer.

as_of_daystring (date) · can be null

The to_day of the row's rates. Null while none is available.

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

The block the row's head values are read at. Null on an older answer.

repovalue · optional

include=repo (default): bittensor.ai's own GitHub content for this life, exactly the data of GET /subnets/{netuid}/repo?generation=<generation>.

profileobject · can be null

include=profile (default): the life's kept subnet page on bittensor.ai (the owner's published profile) and its chain logo. Null (no_page) when the life kept neither.

17 fields in profile
generationinteger · unit id · can be null

Opaque life id (the life's registration identifier), NOT a block height; use life_start_height for the first block. The life this page was matched to: the row's generation.

life_start_heightinteger · unit block · can be null

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

is_current_lifeboolean · can be null

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

logo_urlstring · can be null

The logo the owner uploaded. Null when none.

banner_urlstring · can be null

The page banner image the owner uploaded. Null when none.

taglinestring · can be null

The owner's tagline, raw. Null when none.

descriptionstring · can be null

The owner's long description, raw. Null when none.

tagsarray of string

The owner's own tags ([] when none); the curated tags are meta.tags.

team_membersarray of objects

The team, in the owner's order.

4 fields in team_members (each item)
namestring

The member's name.

rolestring · can be null

Their role, as the owner wrote it. Null when none.

avatar_urlstring · can be null

Their avatar image URL. Null when none.

socialobject

Their profiles, platform name to URL ({} when none), as the owner wrote them.

github_urlstring · can be null

The repository URL the owner gave. Null when none.

documentation_urlstring · can be null

The documentation URL the owner gave. Null when none.

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

The owner's stated minimum stake to validate, in rao (owner-provided, not a chain value).

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

The owner's hardware notes, raw. Null when none.

updated_atstring (date-time) · can be null

When the owner last saved the page. Null when only the cached logo is served.

Format: date and time, ISO 8601 in UTC
pageobject · can be null · deprecated

The same record as profile, under its old name (include=page, which serves both). Deprecated: use profile; sunset 2027-02-15.

Deprecated since 2026-10-16, removed after 2027-02-15. Use profile instead.
17 fields in page
generationinteger · unit id · can be null

Opaque life id (the life's registration identifier), NOT a block height; use life_start_height for the first block. The life this page was matched to: the row's generation.

life_start_heightinteger · unit block · can be null

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

is_current_lifeboolean · can be null

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

logo_urlstring · can be null

The logo the owner uploaded. Null when none.

banner_urlstring · can be null

The page banner image the owner uploaded. Null when none.

taglinestring · can be null

The owner's tagline, raw. Null when none.

descriptionstring · can be null

The owner's long description, raw. Null when none.

tagsarray of string

The owner's own tags ([] when none); the curated tags are meta.tags.

team_membersarray of objects

The team, in the owner's order.

4 fields in team_members (each item)
namestring

The member's name.

rolestring · can be null

Their role, as the owner wrote it. Null when none.

avatar_urlstring · can be null

Their avatar image URL. Null when none.

socialobject

Their profiles, platform name to URL ({} when none), as the owner wrote them.

github_urlstring · can be null

The repository URL the owner gave. Null when none.

documentation_urlstring · can be null

The documentation URL the owner gave. Null when none.

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

The owner's stated minimum stake to validate, in rao (owner-provided, not a chain value).

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

The owner's hardware notes, raw. Null when none.

updated_atstring (date-time) · can be null

When the owner last saved the page. Null when only the cached logo is served.

Format: date and time, ISO 8601 in UTC
unavailable_reasonsobject

For each included section served null, by name: why ({reason, detail}). {} when every included section is served.

Response headers

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

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

Cache-Control

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

CDN-Cache-Control

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

X-BTAI-Stale

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

X-BTAI-Stale-As-Of

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

RateLimit-Policy

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

RateLimit

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

X-RateLimit-Limit

The tier's request quota of the current window.

X-RateLimit-Remaining

Requests left in the current window.

X-RateLimit-Reset

When the current window resets, Unix seconds.

Status codes

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

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

Error codes

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

From the API's published specification, version 1.165.0.