One life of a subnet slot: its window, holders, emissions, revenue, hyperparameters, metagraph, repository
https://api.bittensor.ai/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
generationasGET /api/v2/subnets/generationsnames it (the stored registration id), or itsstart_height; the id is matched first. Not an integer >= 0: a 400INVALID_GENERATION; neither of a life of the slot: a 404GENERATION_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 butstake_yields(on request only:include=stake_yields). Anything else is a 400INVALID_INCLUDE.- amount_raoquery· string
The TAO
stake_yieldsquotes each pool at, a decimal integer 1..1000000000000000000 in rao (as onGET /api/v2/subnets/{netuid}/stake-yields). Omitted: the rows carry no at-amount member (at_amount_omitted). Anything else is a 400INVALID_AMOUNT.- from_dayquery· string (date)
The first UTC day (
YYYY-MM-DD) the day sections andmarksserve; before the life's first day it is that day. Omitted: the first of the 90 days ending atto_day. Not a day: a 400INVALID_DAY; afterto_day, or more than 366 days before it: a 400INVALID_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 400INVALID_DAY; a day before the life (no day served): a 400INVALID_RANGEfrom 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/generationsserves 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
netuidslot, 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 togeneration, which stays the id.- generationinteger · unit id
Opaque life id (the life's registration identifier), NOT a block height; use
life_start_heightfor the first block. This life's id. Candles and pools are keyed on it, and it is thegenerationof/subnets/{netuid}/candles. Often equal tostart_height, but runtime v133 set the key retroactively, so a life alive then has an id later than itsstart_height(SN1: 1,497,824 for a life that began at 172,898); a life that ended before v133 without one uses itsstart_height.- 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.- 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'sstart_heightis 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's0x+ 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 fromowner_at_startwhen 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_heightsays when), itslogo_urlour 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_reasonsays 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.
- 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_endnull). 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_heightis the recorded end. True: the chain recorded the removal (end_reasonremoved). False:superseded, soend_heightis 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_changesonly (absent otherwise; it needsnetuid): 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) andmarksserve:from_day, else the first of the life's last 90 days; never beforefirst_day.- Format: date, YYYY-MM-DD
- served_to_daystring (date)
The last UTC day they serve:
to_day, elselast_day; never afterlast_day.- Format: date, YYYY-MM-DD
- served_completeboolean
True when the served days are the whole life (
first_day..last_day); false: page withfrom_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 inunavailable_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_countmay 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 beforemeta.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, withposition_countandmax_position_alpha_rao, when the pools' day-end stakers cannot be whole (fewer positions than holders) or disagree with the holders (the largest position abovetop10_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 abovetop10_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 withposition_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_raois 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 inunavailable_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_raoexcept 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 inalpha_raoortao_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_alphashows that price to the whole rao, so this is at leastalpha_raoxprice_rao_per_alpha/ 1e9 (floored) and less than 1 rao per whole alpha above it (root: exactlyalpha_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 inalpha_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.
- 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 inunavailable_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_cutemission 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_raoat 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_dividendcredited 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_raoat 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 inunavailable_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_lifetrue,days_available0, every figure null.- Format: date, YYYY-MM-DD
- to_daystring (date) · can be null
The window's last UTC day (
meta.last_day). Null withfrom_daywhen 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_availableinstead. - 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 withinjected_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_raosum 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 andcompleteis 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_raosplit 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 ofwindow_daysback: a younger life serves its days so far (completefalse; 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 inunavailable_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 ahookchange, 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, ...).BurnandDifficultyare 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_beforeis the item's storage default.- value_aftervalue
The value written, decoded as
value_before. Null whenremoved.- removedboolean
True when the change removed the key (the item falls back to its default).
- value_before_rawstring · unit id · can be null
value_beforeas stored, SCALE0xhex. Null when the key did not exist.- Format: hex: 0x and hex digits
- value_after_rawstring · unit id · can be null
value_afteras stored, SCALE0xhex. Null whenremoved.- 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:calldissolution_cleanupwhen a dissolved subnet's freed slot is reset, thennetwork_registrationwhen 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.callthat made the change: the extrinsic's innermost AdminUtils call, else its top-level call;dissolution_cleanupornetwork_registrationfor ahookchange. Null withorigin.- call_idstring · can be null
That call's id (
/api/v2/calls/{id}). Null withcall.- 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 inunavailable_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: thedataofGET /subnets/{netuid}/marks(events, whale trades, liquidity changes; each oldest first).3 fields in marks
- eventsarray of objects
Chain events (every
*-registration/*-change/runtime-upgradekind 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) orroot_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_heightfor the first block. This life. Null on root.- 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.- 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_raowas 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_ratiorates; a root row'saccrual.at_amountis quoted at 1 TAO). False when quoted atamount_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,
ascordesc; 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 ofGET /subnets/{netuid}/stake-yields, without this API's figures priced at the head (a past life's pool is not the pool now):exitis null andat_amount.breakeven_stateunknown. 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.daysdays 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_childrenorstandard. Null on a row whose pool has no figures fordata.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_readyorpool_refused.- Format: decimal number, as a string · can be negative
- stake_tierstring · can be null
lowwhen the pool's own stake A is below X, elsenormal. 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
- 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
takeorder'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_stakeorder'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_pooladded by this API whendata.fv_levelisL3). 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_stakeorder'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,
instantto free TAO atdata.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_dayof 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 thedataofGET /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_heightfor the first block. The life this page was matched to: the row'sgeneration.- 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.- logo_urlstring · can be null
The logo 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.
- featured_linksarray of objects
Links the owner features, in their order.
2 fields in featured_links (each item)
- titlestring
The link's label, as the owner wrote it.
- urlstring
The link's URL, as the owner wrote it.
- 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.
- 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
- chain_logoobject · can be null
The cached on-chain logo with suggested colours. Null when none matches the live identity.
4 fields in chain_logo
- urlstring
The cached logo (our CDN), served only while the live identity points at it.
- suggested_primarystring · can be null
A primary colour extracted from the logo,
#rrggbb. Null when none was extracted.- suggested_secondarystring · can be null
A secondary colour extracted from the logo,
#rrggbb. Null when none.- suggested_accentstring · can be null
An accent colour extracted from the logo,
#rrggbb. Null when none.
- 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
profileinstead. 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_heightfor the first block. The life this page was matched to: the row'sgeneration.- 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.- logo_urlstring · can be null
The logo 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.
- featured_linksarray of objects
Links the owner features, in their order.
2 fields in featured_links (each item)
- titlestring
The link's label, as the owner wrote it.
- urlstring
The link's URL, as the owner wrote it.
- 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.
- 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
- chain_logoobject · can be null
The cached on-chain logo with suggested colours. Null when none matches the live identity.
4 fields in chain_logo
- urlstring
The cached logo (our CDN), served only while the live identity points at it.
- suggested_primarystring · can be null
A primary colour extracted from the logo,
#rrggbb. Null when none was extracted.- suggested_secondarystring · can be null
A secondary colour extracted from the logo,
#rrggbb. Null when none.- suggested_accentstring · can be null
An accent colour extracted from the logo,
#rrggbb. Null when none.
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
- BILLING_UNAVAILABLE
- BUDGET_EXCEEDED
- CONCURRENCY_LIMIT
- GENERATION_NOT_FOUND
- INSUFFICIENT_PERMISSIONS
- INTERNAL_ERROR
- INVALID_AMOUNT
- INVALID_DAY
- INVALID_GENERATION
- INVALID_INCLUDE
- INVALID_NETUID
- INVALID_RANGE
- NOT_READY
- PAYMENT_REQUIRED
- PLAN_REQUIRED
- RATE_LIMITED
- SERVICE_UNAVAILABLE
- SOURCE_BUSY
- SOURCE_NOT_READY
- SOURCE_TIMEOUT
- SUBNET_NOT_FOUND
- UNAUTHORIZED
- UNKNOWN_PARAMETER
- VALIDATION_ERROR
From the API's published specification, version 1.165.0.