Skip to content
TAO$188.36
BTC0.002929
MCap$2.22B
Vol$86.25M

API reference / Subnets

One subnet: price, changes, market cap, volume

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

One subnet's row of the directory.

Full description

One subnet's row of the directory (GET /api/v2/subnets) at one block, as an object: the runtime spot price in TAO and USD, its change over 1 h / 24 h / 7 d / 30 d with the prices then (null across a re-registration: never compared across generations), the 24 h high and low, the pool reserves, alpha outstanding, alpha burned and recycled (AlphaAssets counters, cumulative since runtime v411, not lifetime, and what they added over 24 h / 7 d / 30 d up to meta.supply_windows_to_height, this generation only), the protocol's alpha and the circulating alpha, market caps at spot (all alpha outside the pool, without the burned, and circulating), buy / sell / net flow and volume over 24 h, volume over 7 d and 30 d, the 24 h swap count and the last swap's height. A 24 h / 7 d / 30 d sum is null (never partial) when the pool history does not reach the window's start for a generation registered before it. Every _usd field is valued at meta.tao_usd, the one TAO/USD price of the snapshot. include=state, include=hyperparams and include=neurons add the subnet's chain state, effective hyperparameters and metagraph counts (head only); include=holders its alpha holders and include=yield its stakers' alpha APY at the latest closed UTC day. Each row also has price_source, the subnet's share and rank of the day's TAO emission (and the rank 30 days earlier), the 30-day price, yield and total returns and the simple 30-day APR, tvl_tao_rao, root_prop (head only), the 7 d / 30 d net flows, the 7-day net alpha emission ratio, holders.hhi_ratio and, with include=buyback, the owner's 30-day buybacks; each windowed figure is null until the history covers its window (never a partial one). meta.totals sums the rows served (subnet count, market cap, TVL, 24 h volume, the median 24 h change, the network swap volume), each sum with an *_is_lower_bound flag when a row's value is unknown. state.pool carries the swap's exact inputs as raw integers at state_height (the TAO and alpha reserves, the fee rate, the Balancer quote weight, the swap mechanism); every row has the data source's daily round_trip_cost_ratio / entry_cost_ratio / exit_cost_ratio (the runtime's simulation at the latest day end, at meta.reference_stake) and cost_model, computed by this API from those raw inputs at state_height with the chain's swap reimplemented exactly (Balancer and stable pools; include=state needed, else its figures are null with unavailable_reason no_state). GET /subnets/{netuid}/quote prices any amount the same way. Also meta.tao_usd_24h_ago and, with include=sparkline, meta.tao_usd_sparkline_7d (hourly TAO/USD aligned index by index with every row's sparkline_7d_tao, now one value per hour); per row emission_share_7d_ago_ratio, tao_recycled_24h_rao, cost_unavailable_reason and change_24h_usd_ratio, computed by this API (the 24 h change in USD); state.lease, state.pool.user_liquidity_enabled / swap_v3_initialized, neurons.max_uids and holders.delegates. On one subnet include also takes the page's sections (the subnet page in ONE call): trades (the newest pool trades, the first page of /subnets/{netuid}/trades), events (the newest events carrying the subnet, the first page of /events?netuid=) and hyperparam_changes (the newest hyperparameter changes, the first page of /subnets/{netuid}/hyperparam-changes), each child_limit rows (default 20, 1..200) in data.<section> with its page meta and truncated in meta.sections.<section>; a section's next_cursor continues its own route called with limit = child_limit. With a section the answer's meta carries no totals. The events and hyperparam_changes sections list the subnet's own (current) life only, from its first block (the changes section's meta names the life). It also takes the page's analytics, each fetched beside the subnet read IN PARALLEL with the page's defaults and served exactly as its own route answers it: revenue (/subnets/{netuid}/revenue, the last 30 days), net_emission (/subnets/{netuid}/net-emission, windows 1, 7, 30), emission_share (/subnets/{netuid}/emission-share, the route's default 90 days) and candles_1d (/subnets/{netuid}/candles?interval=1d, the last 90 daily candles of the current generation), rows in data.<name>, the route's meta in meta.sections.<name>.meta. A section that fails or is not ready is null with meta.sections.<name>.unavailable_reason (not_ready, not_applicable: revenue on root, or source_unavailable); the page is never failed for one. Head only (400 INCLUDE_AT_HEAD_ONLY with at). to_day reads a closed day at its last block (the day view; holders, yield and emission that day's), final only: a day not final yet is a 503 NOT_FINAL, one not available yet a 503 NOT_READY. The analytics sections and valuation stay head only with to_day too (400 INCLUDE_AT_HEAD_ONLY). A slot with no registered subnet at meta.at is a 404 SUBNET_NOT_FOUND. Errors are application/problem+json: INVALID_NETUID, INVALID_CHILD_LIMIT, INVALID_AT, INVALID_DAY, INVALID_INCLUDE, AT_OUT_OF_COVERAGE, BLOCK_NOT_FOUND (404), UNKNOWN_PARAMETER, NOT_READY (503: a to_day not available yet), INCLUDE_AT_HEAD_ONLY, SUBNET_NOT_FOUND (404), SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503).

Path parameters

netuidpath, required· integer · 0 to 65535

Subnet slot (0 = root).

Query parameters

atquery· string

The block the answer is for: a block height (9179640), a 0x block hash, or an RFC 3339 time (2026-09-30T10:00:00Z, resolved to the last block at or before it). Omitted: the latest block the source has processed. Block 0 (the genesis block, by height or hash) is a 400 INVALID_AT: it has no timestamp. A time the indexed head has not reached yet (in the future, or not indexed yet) is a 503 NOT_FINAL with Retry-After, never an answer at an earlier block.

Format: a block height, a 0x block hash, or an RFC 3339 time
includequery· string

A comma list of sparkline (fills sparkline_7d_tao, 7 d of hourly closes, and sparkline_7d_complete), state (fills state: epoch, pending emission, lifetime volume, registration figures and the owner's lock), hyperparams (fills hyperparams: the effective hyperparameters, with the registrations over 24 h / 7 d / 30 d in the current generation, proof of work among them, up to meta.registrations_to_height), neurons (fills neurons: the metagraph counts), holders (fills holders: alpha holders by coldkey, top-10 share and Nakamoto coefficient at the latest closed UTC day at or before meta.at) and yield (fills yield: the stakers' alpha APY, each pool's value-per-share growth net of the validator's take, alpha-weighted, at the same day), emission (fills emission: the alpha the subnet's emission credited by component over 1 / 7 / 30 closed UTC days) and buyback (fills the owner's two buyback measures: owner_pool_buys_*, the GROSS pool buys, TAO the subnet owner's coldkey spent buying its alpha over 30 d and over the life, and owner_buyback_burn_*, its add_stake_burn buybacks, TAO staked and alpha burned; the pool buys' earlier names owner_buyback_30d_tao_rao .. owner_buyback_lifetime_from_height are served alongside with the same values for one version, deprecated; reads 30 days of trades for every subnet's owner), and meta (fills meta: bittensor.ai's own content for the subnet, not chain data: display name and logo, tags, the owner's published brand colours and tagline, the repository and display-ready text, matched to the row's generation; no extra data-source call). On GET /subnets/{netuid} only, valuation (fills valuation: the alpha's USD Mayer multiple and power-law fair value in this generation, computed by this API from the daily closes; one more data-source call, cached 300 s; head only, 400 INCLUDE_AT_HEAD_ONLY with at; on the list a 400 INVALID_INCLUDE), and profile (fills profile: the owner's published subnet page on bittensor.ai, banner, description, links, team and owner-provided notes, with the cached on-chain logo and its suggested colours, matched to the row's generation like meta (every life keeps its own page: with at inside an ended life, that life's); no extra data-source call, +0; on the list a 400 INVALID_INCLUDE; page is its deprecated spelling, and either fills both profile and the deprecated page), and halving (fills halving: the subnet's ALPHA halving schedule, computed by this API from the row's alpha_issuance_rao, the halvings so far, the emission now and after the next halving and the issuance thresholds; with state checked against the chain's last emission; no extra data-source call, +0; on the list a 400 INVALID_INCLUDE). Members combine freely (state,meta,page,valuation), each registration (fills registration: the registration and pruning parameters chain state stores per subnet, Burn, BurnHalfLife, BurnIncreaseMult, EMAPriceHalvingBlocks, ImmuneOwnerUidsLimit, MinAllowedUids and RootClaimableThreshold, the runtime's default where none is stored (defaulted_items); one more data-source read beside the subnets, meta.sections.registration says where it was read, or why registration is null: not_ready (not deployed on this data source yet) or source_unavailable, the rest of the answer served either way; on the directory head only, 400 INCLUDE_AT_HEAD_ONLY with at or to_day; on one subnet read at the answer's block). state, hyperparams and neurons are read at the head only (null off it). Omitted, those members are null. Anything else is a 400 INVALID_INCLUDE. With meta, an answer pinned by at is cached as slow (5 min), not settled: the content is today's. Metering: the route's weight (2) plus buyback +1 (and registration +1 on the directory); every other include +0. On one subnet include also takes the page's sections (the subnet page in ONE call): trades (the newest pool trades, the first page of /subnets/{netuid}/trades), events (the newest events carrying the subnet, the first page of /events?netuid=) and hyperparam_changes (the newest hyperparameter changes, the first page of /subnets/{netuid}/hyperparam-changes), each child_limit rows (default 20, 1..200) in data.<section> with its page meta and truncated in meta.sections.<section>; a section's next_cursor continues its own route called with limit = child_limit. With a section the answer's meta carries no totals. The events and hyperparam_changes sections list the subnet's own (current) life only, from its first block (the changes section's meta names the life). It also takes the page's analytics, each fetched beside the subnet read IN PARALLEL with the page's defaults and served exactly as its own route answers it: revenue (/subnets/{netuid}/revenue, the last 30 days), net_emission (/subnets/{netuid}/net-emission, windows 1, 7, 30), emission_share (/subnets/{netuid}/emission-share, the route's default 90 days) and candles_1d (/subnets/{netuid}/candles?interval=1d, the last 90 daily candles of the current generation), rows in data.<name>, the route's meta in meta.sections.<name>.meta. A section that fails or is not ready is null with meta.sections.<name>.unavailable_reason (not_ready, not_applicable: revenue on root, or source_unavailable); the page is never failed for one. Head only (400 INCLUDE_AT_HEAD_ONLY with at).

child_limitquery· integer · default 20 · 1 to 200

Rows per section (trades, events, hyperparam_changes), 1..200 (default 20); ignored without a section. Anything else is a 400 INVALID_CHILD_LIMIT.

section_eventsquery· string

Only with include=events: the events section holds only these events, a comma list of Pallet.Event names (SubtensorModule.NetworkAdded) or lifecycle (the subnet's lifecycle: NetworkAdded, NetworkRemoved, SubnetOwnerHotkeySet, SubnetIdentitySet, SubnetIdentityRemoved, FirstEmissionBlockNumberSet). Its next_cursor continues on /events?netuid= with the same names as event (at most 32). Without include=events, or malformed, a 400 INVALID_EVENT.

to_dayquery· string (date)

A closed UTC day, YYYY-MM-DD (the day view): the read at that day's last block, with holders, yield and emission that day's; meta.to_day echoes it. Not with at (both: a 400 INVALID_AT). Only a final day is served: today or later is a 503 NOT_FINAL before any call, and so is a closed day whose last block is not followed by an indexed one yet (or that the source has not reached); one whose day figures are not available yet is a 503 NOT_READY; never an earlier day. A day before the chain's first block (2023-03-20) is a 400 AT_OUT_OF_COVERAGE. A served day is cached as settled. Anything else is a 400 INVALID_DAY.

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 subnet in slot netuid at meta.at, with the sections include asks for.

netuidinteger · unit id

Subnet slot (0 = root).

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 of the subnet occupying netuid: netuid is a reused slot and generation tells its lives apart (compare or join on it). 0 for root. Null when not recorded.

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.

life_start_heightinteger · unit block · can be null

The first block of the subnet's current life (its NetworkAdded event): where this subnet's history starts. Use it, not generation, for heights and dates (age, how far history goes back). Null on an older data-source answer that does not carry it.

life_start_timestring (date-time) · can be null

The time of life_start_height, RFC 3339 UTC. Null with it.

Format: date and time, ISO 8601 in UTC
generation_indexinteger · unit count · can be null

Which subnet this is for its netuid slot: 1 for the slot's first subnet, 2 for the one registered after the first was dissolved, and so on: 1 + the slot's NetworkAdded events before this generation, so it is genesis-safe: a subnet that came with the chain, without a NetworkAdded event, reads 1. A label next to generation, which stays the id. Null until the decoded events reach genesis (block 1; a count from a later floor could be wrong, so none is given: no partial counts); on 2026-10-01 they reach back to ~5.28 M, so it is null on every subnet.

mechanisminteger · unit id · can be null

SubtensorModule.SubnetMechanism: 0 = stable (root, 1:1), 1 = dynamic (AMM pool). Null when not recorded. Clients must accept values not documented yet.

namestring · can be null

SubnetIdentitiesV3.subnet_name. Read at the head only: null off the head (see meta.supply_counters), and null when the owner has set no name.

symbolstring · can be null

SubtensorModule.TokenSymbol (the alpha token's symbol). Head only, like name; null when unset.

identityobject · can be null

The owner's on-chain identity (SubnetIdentitiesV3). Head only: null off the head, and null when the subnet has no identity entry (the runtime removes it when a subnet dissolves, so it always belongs to the live generation). Each member is null when unset.

8 fields in identity
urlstring · can be null

The subnet's website (SubnetIdentitiesV3.subnet_url), as the owner set it; null when unset (empty).

githubstring · can be null

The subnet's GitHub repository (SubnetIdentitiesV3.github_repo), as the owner set it; null when unset (empty).

discordstring · can be null

The subnet's Discord (SubnetIdentitiesV3.discord), as the owner set it; null when unset (empty).

contactstring · can be null

A contact for the subnet (SubnetIdentitiesV3.subnet_contact), as the owner set it; null when unset (empty).

logo_urlstring · can be null

The subnet's logo (the image SubnetIdentitiesV3.logo_url names, for this life): 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.

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.

descriptionstring · can be null

The subnet's description (SubnetIdentitiesV3.description), as the owner set it; null when unset (empty).

additionalstring · can be null

Free-form additional text (SubnetIdentitiesV3.additional), as the owner set it; null when unset (empty).

price_taostring · unit tao_per_alpha · 9 decimals

Spot price of one alpha in TAO at meta.at (the runtime's current alpha price; 1 on root), 9 decimals.

Format: decimal number with 9 places, as a string
price_usdstring · unit usd_per_alpha · 6 decimals · can be null

price_tao x meta.tao_usd: USD per alpha (a price), 6 decimals. Null without meta.tao_usd.

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

Price change over 1 h: price_tao / the price at the last block at or before meta.at - 1 h - 1, a signed ratio with 6 decimals (0.05 = +5 %). Null when that block is before the pool history or the slot then held another generation (the subnet was registered since): never compared across subnet lifetimes.

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

Price change over 24 h: price_tao / the price at the last block at or before meta.at - 24 h - 1, a signed ratio with 6 decimals (0.05 = +5 %). Null when that block is before the pool history or the slot then held another generation (the subnet was registered since): never compared across subnet lifetimes.

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

Price change over 7 d: price_tao / the price at the last block at or before meta.at - 7 d - 1, a signed ratio with 6 decimals (0.05 = +5 %). Null when that block is before the pool history or the slot then held another generation (the subnet was registered since): never compared across subnet lifetimes.

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

Price change over 30 d: price_tao / the price at the last block at or before meta.at - 30 d - 1, a signed ratio with 6 decimals (0.05 = +5 %). Null when that block is before the pool history or the slot then held another generation (the subnet was registered since): never compared across subnet lifetimes.

Format: decimal number, as a string · can be negative
price_1h_ago_taostring · unit tao_per_alpha · can be null · beta

The pool price (TAO per alpha) at the last block at or before meta.at - 1 h, UNROUNDED (the runtime's exact fixed-point price, up to 64 decimals): the divisor of price_change_1h_ratio (price_tao / it - 1, before that ratio's 6-place rounding), so a client can recompute the change exactly; 1 on root. Null under the ratio's conditions (never across a re-registration), and on an older data version's answer.

Format: decimal number, as a string
price_24h_ago_taostring · unit tao_per_alpha · 9 decimals · can be null

The price (TAO per alpha) at the last block at or before meta.at - 24 h, 9 decimals: the basis of price_change_24h_ratio. Null under the same conditions.

Format: decimal number with 9 places, as a string
price_7d_ago_taostring · unit tao_per_alpha · 9 decimals · can be null

The price (TAO per alpha) at the last block at or before meta.at - 7 d, 9 decimals: the basis of price_change_7d_ratio. Null under the same conditions.

Format: decimal number with 9 places, as a string
price_30d_ago_taostring · unit tao_per_alpha · 9 decimals · can be null

The price (TAO per alpha) at the last block at or before meta.at - 30 d, 9 decimals: the basis of price_change_30d_ratio. Null under the same conditions.

Format: decimal number with 9 places, as a string
high_24h_price_taostring · unit tao_per_alpha · 9 decimals · can be null

Highest runtime price (TAO per alpha) in this generation's hourly pool candles over the 24 h before meta.at (from the start of the hour 24 h back), 9 decimals. Null without a candle in that window.

Format: decimal number with 9 places, as a string
low_24h_price_taostring · unit tao_per_alpha · 9 decimals · can be null

Lowest runtime price (TAO per alpha) in the same candles, 9 decimals. Null with high_24h_price_tao.

Format: decimal number with 9 places, as a string
pool_tao_raostring · unit rao (÷1e9) · can be null

TAO reserve of the pool (SubnetTAO) at meta.at, in rao.

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

Alpha reserve of the pool (SubnetAlphaIn) at meta.at, in alpha rao.

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

SubnetAlphaOut at meta.at: alpha outside the pool, in alpha rao. It still counts burned alpha (burn_subnet_alpha leaves it unchanged) and the protocol's alpha: see effective_alpha_out_rao and circulating_alpha_rao.

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

Swap.BalancerAlphaReservoir at meta.at: alpha the balancer holds outside the pool's price reserves, in alpha rao; 0 before runtime v432 or where the key is absent. Null on an older data-source answer that does not carry it.

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

The subnet's alpha issuance as the runtime counts it (the measure its halving uses), in alpha rao: pool_alpha_rao + alpha_out_rao + alpha_reservoir_rao, checked on every answer. Null with alpha_reservoir_rao.

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

AlphaAssets.AlphaBurned: alpha burned in this subnet's CURRENT generation, cumulative, in alpha rao. From runtime v446 (height 8,843,320) it is the generation's whole-life burn: v446 added the burn from before the counter existed (v411) and removed a previous generation's carry, and every registration resets it. Read at an at before v446 it is the raw counter (since v411, and on a re-registered slot the previous generation's carry included). A subnet with no counter entry serves the storage default "0" (an absent entry is 0 on chain); null on root. Null off the head (at below the pool dataset's head; see meta.supply_counters).

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

AlphaAssets.AlphaRecycled: alpha recycled in this subnet's current generation, cumulative, in alpha rao, since runtime v411 (from v446 the previous generation's carry is removed and every registration resets it). A subnet with no counter entry serves the storage default "0" (an absent entry is 0 on chain); null on root. Null off the head (at below the pool dataset's head; see meta.supply_counters).

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

Alpha burned on this subnet over the last 24 hours: what AlphaAssets.AlphaBurned added between the block 24 hours before meta.at and meta.supply_windows_to_height (the sum of the counter's per-block increases), in alpha rao; never negative, 0 when nothing was added (also where the counter has no entry). Only the subnet's current generation: when the slot was dissolved inside the window, the count starts at the counter's reset (a predecessor's alpha is not carried over). Null while the counter history does not span the window (30 days were not available on 2026-10-01), when that history is more than 100 blocks behind meta.at, and on root. Unlike the cumulative counters it is served off the head too. Floored at the current life's first block (life_start_height): before runtime v446 a re-registration did not reset the counter.

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

Alpha burned on this subnet over the last 7 days: what AlphaAssets.AlphaBurned added between the block 7 days before meta.at and meta.supply_windows_to_height (the sum of the counter's per-block increases), in alpha rao; never negative, 0 when nothing was added (also where the counter has no entry). Only the subnet's current generation: when the slot was dissolved inside the window, the count starts at the counter's reset (a predecessor's alpha is not carried over). Null while the counter history does not span the window (30 days were not available on 2026-10-01), when that history is more than 100 blocks behind meta.at, and on root. Unlike the cumulative counters it is served off the head too. Floored at the current life's first block (life_start_height): before runtime v446 a re-registration did not reset the counter.

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

Alpha burned on this subnet over the last 30 days: what AlphaAssets.AlphaBurned added between the block 30 days before meta.at and meta.supply_windows_to_height (the sum of the counter's per-block increases), in alpha rao; never negative, 0 when nothing was added (also where the counter has no entry). Only the subnet's current generation: when the slot was dissolved inside the window, the count starts at the counter's reset (a predecessor's alpha is not carried over). Null while the counter history does not span the window (30 days were not available on 2026-10-01), when that history is more than 100 blocks behind meta.at, and on root. Unlike the cumulative counters it is served off the head too. Floored at the current life's first block (life_start_height): before runtime v446 a re-registration did not reset the counter.

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

Alpha recycled on this subnet over the last 24 hours: what AlphaAssets.AlphaRecycled added between the block 24 hours before meta.at and meta.supply_windows_to_height (the sum of the counter's per-block increases), in alpha rao; never negative, 0 when nothing was added (also where the counter has no entry). Only the subnet's current generation: when the slot was dissolved inside the window, the count starts at the counter's reset (a predecessor's alpha is not carried over). Null while the counter history does not span the window (30 days were not available on 2026-10-01), when that history is more than 100 blocks behind meta.at, and on root. Unlike the cumulative counters it is served off the head too. Floored at the current life's first block (life_start_height): before runtime v446 a re-registration did not reset the counter.

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

Alpha recycled on this subnet over the last 7 days: what AlphaAssets.AlphaRecycled added between the block 7 days before meta.at and meta.supply_windows_to_height (the sum of the counter's per-block increases), in alpha rao; never negative, 0 when nothing was added (also where the counter has no entry). Only the subnet's current generation: when the slot was dissolved inside the window, the count starts at the counter's reset (a predecessor's alpha is not carried over). Null while the counter history does not span the window (30 days were not available on 2026-10-01), when that history is more than 100 blocks behind meta.at, and on root. Unlike the cumulative counters it is served off the head too. Floored at the current life's first block (life_start_height): before runtime v446 a re-registration did not reset the counter.

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

Alpha recycled on this subnet over the last 30 days: what AlphaAssets.AlphaRecycled added between the block 30 days before meta.at and meta.supply_windows_to_height (the sum of the counter's per-block increases), in alpha rao; never negative, 0 when nothing was added (also where the counter has no entry). Only the subnet's current generation: when the slot was dissolved inside the window, the count starts at the counter's reset (a predecessor's alpha is not carried over). Null while the counter history does not span the window (30 days were not available on 2026-10-01), when that history is more than 100 blocks behind meta.at, and on root. Unlike the cumulative counters it is served off the head too. Floored at the current life's first block (life_start_height): before runtime v446 a re-registration did not reset the counter.

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

floor(alpha_out_rao x price_tao), in rao of TAO: a spot valuation of all alpha outside the pool.

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

market_cap_spot_tao_rao in USD at meta.tao_usd, 6 decimals. Null without a price.

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

floor((alpha_out_rao - alpha_burned_rao) x price_tao), in rao of TAO: the spot market cap without the alpha burned since v411. Null when alpha_burned_rao is null, except on root (where it equals market_cap_spot_tao_rao), so also off the head.

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

alpha_out_rao - alpha_burned_rao (floored at 0), in alpha rao: SubnetAlphaOut without the burned alpha it still counts. Null when alpha_burned_rao is null (so off the head), except on root (alpha_out_rao).

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

SubtensorModule.SubnetProtocolAlpha at meta.at: alpha the coinbase bought with excess TAO, counted in alpha_out_rao but held by no account, in alpha rao. Null where the chain has no entry. Null off the head (at below the pool dataset's head; see meta.supply_counters).

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

Alpha held by accounts: alpha_out_rao - alpha_burned_rao - protocol_alpha_rao (floored at 0; circulating_basis names what was subtracted), in alpha rao. Root: alpha_out_rao. Null when alpha_burned_rao is null, so off the head except on root.

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

What circulating_alpha_rao excludes: excludes_burned_and_protocol, excludes_burned (no protocol alpha entry) or alpha_out (root: nothing excluded). Null with circulating_alpha_rao. Clients must accept values not documented yet.

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

floor(circulating_alpha_rao x price_tao), in rao of TAO: the spot market cap of the alpha accounts hold. Null with circulating_alpha_rao.

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

TAO into plus out of the pool by extrinsic swap steps in this generation's hourly buckets over the 24 h before meta.at (from the start of the hour 24 h back), in rao; 0 when none (a measured zero). Null when the pool dataset's coverage does not reach the window's start and this generation began before coverage (the sum would miss blocks: never a partial sum); a generation registered inside coverage has its whole window and is served.

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

volume_24h_tao_rao in USD at meta.tao_usd, 6 decimals. Null without a price.

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

TAO into the pool by buys over the same 24 h, in rao; 0 when none. Null when the pool dataset's coverage does not reach the window's start and this generation began before coverage (the sum would miss blocks: never a partial sum); a generation registered inside coverage has its whole window and is served.

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

TAO out of the pool by sells over the same 24 h, in rao; 0 when none. Null when the pool dataset's coverage does not reach the window's start and this generation began before coverage (the sum would miss blocks: never a partial sum); a generation registered inside coverage has its whole window and is served.

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

buy_volume_24h_tao_rao - sell_volume_24h_tao_rao: net TAO into the pool by swaps over the same 24 h, signed, in rao (negative = net outflow); 0 when none. Null with the two volumes: Null when the pool dataset's coverage does not reach the window's start and this generation began before coverage (the sum would miss blocks: never a partial sum); a generation registered inside coverage has its whole window and is served.

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

TAO into plus out of the pool over the 7 d before meta.at (this generation), in rao. Null when the pool dataset's coverage does not reach the window's start and this generation began before coverage (the sum would miss blocks: never a partial sum); a generation registered inside coverage has its whole window and is served.

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

TAO into plus out of the pool over the 30 d before meta.at (this generation), in rao. Null when the pool dataset's coverage does not reach the window's start and this generation began before coverage (the sum would miss blocks: never a partial sum); a generation registered inside coverage has its whole window and is served.

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

Extrinsic swap steps through the pool over the same 24 h. Null when the pool dataset's coverage does not reach the window's start and this generation began before coverage (the sum would miss blocks: never a partial sum); a generation registered inside coverage has its whole window and is served.

last_swap_heightinteger · unit block · can be null

Height of the latest extrinsic swap step through the pool at or before meta.at. Null when the pool has no swap in the trade history.

sparkline_7d_taoarray of string · unit tao_per_alpha · 9 decimals · can be null

Only with include=sparkline, else null: this generation's hourly pool closes (TAO per alpha, 9 decimals) over the 7 d before meta.at, oldest first. One value per hour from meta.tao_usd_sparkline_7d_from (aligned index by index with meta.tao_usd_sparkline_7d): an hour without a candle repeats the last close before it, and an hour before the generation's first candle is null. (On an older data version's answer an hour without a candle is absent, so the series can be shorter.) See sparkline_7d_complete.

Format: decimal number with 9 places, as a string
sparkline_7d_completeboolean · can be null

Only with include=sparkline, else null: false when sparkline_7d_tao starts after the window's start because the candle coverage is shorter than 7 d (the series is not a whole 7 d), true otherwise.

stateobject · can be null

Only with include=state, else null; head only: null off the head too (an at below the pool dataset's head). The subnet's epoch, pending emission, lifetime volume, registration figures, owner lock and pool state (EMA prices, fee, per-block injection, TAO flow), from chain state at meta.at.

15 fields in state
epochobject

Tempo and the last epoch's block.

3 fields in epoch
tempointeger · unit blocks · can be null

SubtensorModule.Tempo: blocks per epoch. Null without an entry.

last_step_heightinteger · unit block · can be null

SubtensorModule.LastMechansimStepBlock: the block of the subnet's last epoch. Null without one.

blocks_since_last_stepinteger · unit blocks · can be null

meta.at height - last_step_height: blocks since the subnet's last epoch (so the two always add up to meta.at). Root has not stepped since dTAO and reads in the millions (4,266,411 on 2026-10-01). Null without a last step.

pending_emissionobject

Alpha accumulated since the last epoch, paid at the next one, per recipient.

3 fields in pending_emission
server_alpha_raostring · unit alpha_rao (÷1e9) · can be null

SubtensorModule.PendingServerEmission: the miners' share, in alpha rao. Null without one.

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

SubtensorModule.PendingValidatorEmission: the validators' share, in alpha rao. Null without one.

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

SubtensorModule.PendingOwnerCut: the owner's cut, in alpha rao. Null without one.

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

SubtensorModule.SubnetVolume: TAO swapped through the pool since this generation registered, in rao. Null without an entry.

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

SubtensorModule.SubnetLocked: TAO locked to register the subnet, in rao. Null without an entry.

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

SubtensorModule.FirstEmissionBlockNumber: the block emission started. Null when not started.

registrations_this_blockinteger · unit count · can be null

SubtensorModule.RegistrationsThisBlock: neuron registrations in block meta.at.

max_registrations_per_blockinteger · unit count · can be null

SubtensorModule.MaxRegistrationsPerBlock. Null when the subnet has no entry (the runtime default applies).

collateral_lock_share_ratiostring · unit ratio · 6 decimals · can be null

SubtensorModule.CollateralLockShare / 65535: the share (0..1) of the neuron registration price that is locked as miner collateral instead of burned, a ratio with 6 decimals; 0 = collateral disabled (the subnet burns the whole price). Null without an entry.

Format: decimal number, as a string
ownerobject

The owner's keys and owner-hotkey locks.

10 fields in owner
coldkeystring · can be null

SubtensorModule.SubnetOwner, SS58 (prefix 42; the source's 0x + 64 hex, rendered). Null without an entry (root).

Format: SS58 address
hotkeystring · can be null

SubtensorModule.SubnetOwnerHotkey, SS58 (prefix 42; the source's 0x + 64 hex, rendered). It can equal coldkey (an owner that set its coldkey as the owner hotkey). Null without an entry (root).

Format: SS58 address
cut_auto_lockboolean · can be null

Whether the owner's cut is locked automatically as it is paid. Null when the chain has no entry.

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

OwnerLock: the perpetual lock to the owner hotkey (its mass), in alpha rao. Null without one.

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

OwnerLock's conviction (U64F64, floored), in alpha rao: it grows toward locked_alpha_rao and equals it once matured. Null without a lock.

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

The block OwnerLock was last updated at. Null without a lock.

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

DecayingOwnerLock: the decaying lock to the owner hotkey (its mass), in alpha rao. Null without one.

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

DecayingOwnerLock's conviction (floored), in alpha rao. Null without a decaying lock.

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

The block DecayingOwnerLock was last updated at. Null without a decaying lock.

locked_circulating_ratiostring · unit ratio · 6 decimals · can be null

locked_alpha_rao / the subnet's circulating_alpha_rao, a ratio with 6 decimals. Null when either is null.

Format: decimal number, as a string
poolobject

The pool's EMA prices, swap fee, per-block injection, TAO flow and emission switches.

22 fields in pool
state_heightinteger · unit block · can be null

The block every raw swap input below (tao_in_rao, alpha_in_rao, fee_rate_u16, quote_weight_perquintill, swap_mechanism) is read at: the state head, one snapshot. Can be a block or two off meta.at. The subnet's cost_model is computed at this block.

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

SubtensorModule.SubnetTAO at state_height: the pool's TAO reserve, raw integer rao.

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

SubtensorModule.SubnetAlphaIn at state_height: the pool's alpha reserve, raw integer alpha rao.

Format: whole number, as a string · on chain: u64
fee_rate_u16integer · unit u16_fraction (÷65535) · can be null

Swap.FeeRate at state_height, raw u16: the fee on a swap is amount_in x fee_rate_u16 / 65535 (33 = 0.0504 %), taken from the amount going in. The storage default of the head's runtime when the subnet has no key. The exact input; fee_ratio is its display form.

quote_weight_perquintillstring · unit perquintill (÷1e18) · can be null

Swap.SwapBalancer.quote at state_height: the TAO side's Balancer weight, raw Perquintill (parts of 1e18; 500000000000000000 = 0.5, the alpha side has the rest). Null where the runtime declares no SwapBalancer (before v423, and v425-v431).

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

The pool's curve at state_height: stable = SubnetMechanism 0 (root and stable subnets: a 1:1 move, no fee, no slippage); a dynamic subnet by the runtime: constant_product before v290, concentrated_liquidity v290-v422, balancer from v423 (a weighted pool over the two reserves). Null when the subnet's mechanism is not recorded. Clients must accept values not documented yet. New values may be added; show an unknown value as is (or generically).

moving_price_taostring · unit tao_per_alpha · 12 decimals · can be null

SubtensorModule.SubnetMovingPrice (I96F32, rendered as a decimal): the slow EMA of the pool price, in TAO per alpha, 12 decimals. The emission split between subnets is computed from it (not from spot); it is clamped at 1.0 by the runtime. 0 on root. Null without an entry.

Format: decimal number, as a string
fast_moving_price_taostring · unit tao_per_alpha · 12 decimals · can be null

SubtensorModule.SubnetFastMovingPrice (FixedU128, rendered as a decimal): a fast EMA of the spot price (600-block half-life, unclamped), in TAO per alpha, 12 decimals. A trading anchor only (basket swaps are bounded against it); no part in emission. Null until the subnet's first update after runtime v464, and on root and pools that never had one (e.g. netuids 59, 82, 86, 108 on 2026-10-01).

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

Swap.FeeRate / 65535: the pool's swap fee as a fraction of the amount swapped, 8 decimals (0.00050355 = the default 33 / 65535, ~0.05 %), for display: fee_rate_u16 is the exact input. Null without an entry.

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

SubtensorModule.SubnetTaoInEmission: TAO injected into the pool's TAO reserve per block, in rao. Null without an entry.

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

SubtensorModule.SubnetAlphaInEmission: alpha injected into the pool's alpha reserve per block, in alpha rao of this subnet. Null without an entry.

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

SubtensorModule.SubnetAlphaOutEmission: alpha emitted per block to the subnet's participants (owner, miners, validators, stakers), in alpha rao of this subnet. Null without an entry.

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

SubtensorModule.SubnetExcessTao: the TAO of the subnet's emission at the last block that could not be injected next to new alpha and was swapped for alpha on the pool instead (a chain buy), in rao. Null without an entry.

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

SubtensorModule.SubnetTaoFlow (i64): the runtime's net user TAO flow accumulator (TAO staked into the subnet through the pool minus TAO unstaked), in rao, signed (+ = net inflow). Until runtime v419 the flow EMA reset it every block (a one-block flow); since v421 (block 8,466,531, 2026-06-23) nothing resets it, so it is the net flow accumulated since block 8,466,530, or since the subnet's registration when that is later. Not a window sum like net_flow_24h_tao_rao. Null without an entry.

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

SubtensorModule.SubnetEmaTaoFlow's EMA (I64F64, rendered as a decimal with 12 places), in TAO rao per block, signed: the EMA of the per-block net user TAO flow that set the subnets' emission shares from runtime v334 to v419 (blocks 6,811,691..8,466,530). Frozen since v421 (block 8,466,531, 2026-06-23), when emission shares moved to the price EMA (moving_price_tao): the runtime no longer advances it, and every live value carries the last-update height 8,466,530 (ema_tao_flow_height). A historical value, not the subnet's current flow: do not present it as live flow. Null for a subnet without a value (registered after the freeze, or never emitting), and on an answer from before the source carried it.

can be negative · Pattern: ^-?[0-9]+\.[0-9]{12}$
ema_tao_flow_heightinteger · unit block · can be null

The block SubnetEmaTaoFlow was last advanced at (the stored tuple's block): 8,466,530 on every value since the freeze, which dates the value. Null with ema_tao_flow_tao_rao.

ema_protocol_flow_tao_raostring · unit rao (÷1e9) · 12 decimals · can be null

SubtensorModule.SubnetEmaProtocolFlow's EMA (I64F64, rendered as a decimal with 12 places), in TAO rao per block, signed: the EMA of the per-block protocol TAO flow (emission + chain buys - root sells) that the flow-based share subtracted (runtime v411-v419). Frozen since v421 (block 8,466,531) like ema_tao_flow_tao_rao, so a historical value, not live flow. Null for a subnet without a value (registered after the freeze), and on an answer from before the source carried it.

can be negative · Pattern: ^-?[0-9]+\.[0-9]{12}$
ema_protocol_flow_heightinteger · unit block · can be null

The block SubnetEmaProtocolFlow was last advanced at: 8,466,530 on every value since the freeze. Null with ema_protocol_flow_tao_rao.

emission_enabledboolean · can be null

SubtensorModule.SubnetEmissionEnabled: false when the subnet's pool-side emission is switched off (TAO in, alpha in and the excess-TAO buy are then zero). Null when the chain has no entry.

owner_cut_enabledboolean · can be null

SubtensorModule.OwnerCutEnabled: whether the subnet owner takes its cut of the alpha emission. Null when the chain has no entry.

user_liquidity_enabledboolean · can be null

Swap.EnabledUserLiquidity: whether users may add liquidity positions to the pool. Declared only by runtimes v290-v422 (the concentrated-liquidity swap), so null while the head's runtime does not declare it (every Balancer runtime, v423 on): null means not applicable, not false.

swap_v3_initializedboolean · can be null

Swap.SwapV3Initialized: whether the concentrated-liquidity pool was initialised. Declared only by runtimes v290-v422, so null while the head's runtime does not declare it.

lifecycleobject

Immunity and the subnet's place in the runtime's prune order (1 = the next subnet dissolved).

4 fields in lifecycle
immuneboolean · can be null

Whether the subnet is still inside its NetworkImmunityPeriod at meta.at (meta.at height < immune_until_height), so it cannot be pruned. Null on root.

immune_until_heightinteger · unit block · can be null

The first block at which the subnet is no longer immune: its registration block (generation) + NetworkImmunityPeriod (864,000 blocks on 2026-10-01). Null on root.

prune_rankinteger · unit count · can be null

Position in the prune order among the non-immune subnets: 1 = the next subnet to be dissolved when a registration needs a slot (lowest moving price; ties: earliest registration). Null while immune, and on root.

next_to_pruneboolean

True on the one subnet with prune_rank 1 (subnetInfo_getSubnetToPrune), false on every other.

leaseobject · can be null

The subnet's lease (null on an older data version's answer): lease_id and the runtime's SubnetLease struct decoded (beneficiary, emissions share, end block, ...). Null when the subnet has no lease.

7 fields in lease
lease_idinteger · unit id

SubtensorModule.SubnetUidToLeaseId: the lease's id (SubnetLeases key).

beneficiarystring · can be null

SubnetLease.beneficiary: the account the lease's emissions share goes to, SS58.

Format: SS58 address
coldkeystring · can be null

SubnetLease.coldkey: the lease's coldkey (the subnet's owner while leased), SS58.

Format: SS58 address
hotkeystring · can be null

SubnetLease.hotkey: the lease's hotkey, SS58.

Format: SS58 address
emissions_share_ratiostring · unit ratio · can be null

SubnetLease.emissions_share (a Percent, 0..100) / 100: the share of the owner's emissions paid to the beneficiary, a ratio (0..1).

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

SubnetLease.end_block (an Option): the block the lease ends. Null = no end.

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

SubnetLease.cost: what the lease cost, in TAO rao.

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

CollateralDrainRatio (U64F64; its default 1 when unset, at most 10, checked): collateral alpha released per alpha of hotkey emission earned, snapshot into each new miner collateral entry. Null on an older data-source answer.

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

A risk indicator for the subnet's owner and its stakers: who the runtime would hand the subnet's ownership to by conviction locks, and how close that is. Null on root (netuid 0, checked) and on an older data-source answer.

11 fields in ownership_takeover
eligible_alpha_raostring · unit alpha_rao (÷1e9)

The alpha the threshold is measured against: SubnetAlphaOut - SubnetProtocolAlpha - AlphaBurned (saturating at 0), alpha rao.

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

NetworkRegisteredAt: the subnet's registration block.

takeover_open_from_heightinteger · unit block

registered_at_height + ONE_YEAR (2,629,800 blocks): from here a takeover can happen.

takeover_openboolean

as_of_height >= takeover_open_from_height (checked): a takeover can happen now.

leader_hotkeyobject · can be null

The hotkey with the most conviction on the subnet, as {ss58, hex}. Null when no hotkey holds any (with leader_conviction_alpha_rao).

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

Its conviction rolled to the block, floored, alpha rao. Null without a leader.

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

The leader hotkey's Owner coldkey, as {ss58, hex}: who would receive the subnet. Null when not known.

leader_share_of_eligible_ratiostring · unit ratio · 8 decimals · can be null

The leader's conviction / eligible_alpha_rao, 8 decimals: compare with threshold_ratio. Null without a leader or without eligible alpha.

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

Always 0.18: the runtime's threshold (conviction x 100 > eligible x 18).

would_transfer_nowboolean · can be null

Whether the runtime would hand the subnet over at the next coinbase block: open, the leader's conviction x 100 > the eligible alpha x 18, and its Owner real and not the current owner (true only with all of them; checked against the members served).

as_of_heightinteger · unit block

The state head the takeover is read at.

alpha_supplyobject · can be null

The subnet's alpha supply against the runtime's cap (runtime v478): the cap, the issuance the halving reads and the swap's reservoir, read at the state head. Null on an answer from before the source carried it.

3 fields in alpha_supply
max_supply_alpha_raostring · unit alpha_rao (÷1e9) · can be null

TotalSupply, 21,000,000 alpha in alpha rao ("21000000000000000"): a runtime constant, the same for every subnet (and for TAO), not storage. Never null in practice (the source states the constant).

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

The runtime's alpha issuance (get_alpha_issuance), the input to the halving, in alpha rao: SubnetAlphaIn + SubnetAlphaOut + reservoir_alpha_rao, at the state head. The row's alpha_issuance_rao is the same measure at meta.at (a block or two apart). Null when the subnet's alpha reserves are not read.

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

Swap.BalancerAlphaReservoir: the swap's protocol alpha reservoir, in alpha rao; 0 when the subnet has no key. Null when not read.

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

Only with include=hyperparams, else null; head only (null off the head). The effective hyperparameters (stored, else the runtime default; defaulted_items names the defaulted ones).

8 fields in hyperparams
tempointeger · unit blocks · can be null

Blocks per epoch (SubtensorModule.Tempo; the runtime default when not stored). Null when not readable.

registrationobject

Neuron registration: burn, PoW, adjustment.

20 fields in registration
allowedboolean · can be null

Whether burn registration is open (SubtensorModule.NetworkRegistrationAllowed; the runtime default when not stored). Null when not readable.

pow_allowedboolean · can be null

Whether proof-of-work registration is open (SubtensorModule.NetworkPowRegistrationAllowed; the runtime default when not stored). Null when not readable.

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

The current registration cost, in rao (SubtensorModule.Burn; the runtime default when not stored). Null when not readable.

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

The floor of the registration cost, in rao (SubtensorModule.MinBurn; the runtime default when not stored). Null when not readable.

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

The cap of the registration cost, in rao (SubtensorModule.MaxBurn; the runtime default when not stored). Null when not readable.

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

TAO recycled by registrations on this subnet, cumulative, in rao (SubtensorModule.RAORecycledForRegistration; the runtime default when not stored). Null when not readable.

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

The current PoW difficulty (a u64 number, not an amount) (SubtensorModule.Difficulty; the runtime default when not stored). Null when not readable.

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

The floor of the PoW difficulty (SubtensorModule.MinDifficulty; the runtime default when not stored). Null when not readable.

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

The cap of the PoW difficulty (SubtensorModule.MaxDifficulty; the runtime default when not stored). Null when not readable.

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

Registrations targeted per adjustment interval (SubtensorModule.TargetRegistrationsPerInterval; the runtime default when not stored). Null when not readable.

this_intervalinteger · unit count · can be null

Registrations so far in the current interval (SubtensorModule.RegistrationsThisInterval; the runtime default when not stored). Null when not readable.

adjustment_interval_blocksinteger · unit blocks · can be null

Blocks between burn / difficulty adjustments (SubtensorModule.AdjustmentInterval; the runtime default when not stored). Null when not readable.

adjustment_alpha_ratiostring · unit ratio · 6 decimals · can be null

Smoothing of the adjustment (u64 / u64::MAX), a ratio with 6 decimals (SubtensorModule.AdjustmentAlpha; the runtime default when not stored). Null when not readable.

Format: decimal number, as a string
immunity_period_blocksinteger · unit blocks · can be null

Blocks a new UID is protected from pruning (SubtensorModule.ImmunityPeriod; the runtime default when not stored). Null when not readable.

registrations_24hinteger · unit count · can be null

Neurons registered on this subnet in the 24 hours before meta.at (SubtensorModule.NeuronRegistered events, burn and proof of work together; burned registrations = this minus the matching pow_registrations_*). The owner's UID placed when the subnet was created emits no event and is not counted. Current generation only, like the burned / recycled windows: when the subnet was re-registered inside the window, the count starts at its registration (generation) and a dissolved predecessor's registrations are left out. The window ends at meta.registrations_to_height. Null unless the decoded events span the window and reach within 100 blocks of meta.at (never a partial count).

registrations_7dinteger · unit count · can be null

Neurons registered on this subnet in the 7 days before meta.at (SubtensorModule.NeuronRegistered events, burn and proof of work together; burned registrations = this minus the matching pow_registrations_*). The owner's UID placed when the subnet was created emits no event and is not counted. Current generation only, like the burned / recycled windows: when the subnet was re-registered inside the window, the count starts at its registration (generation) and a dissolved predecessor's registrations are left out. The window ends at meta.registrations_to_height. Null unless the decoded events span the window and reach within 100 blocks of meta.at (never a partial count).

registrations_30dinteger · unit count · can be null

Neurons registered on this subnet in the 30 days before meta.at (SubtensorModule.NeuronRegistered events, burn and proof of work together; burned registrations = this minus the matching pow_registrations_*). The owner's UID placed when the subnet was created emits no event and is not counted. Current generation only, like the burned / recycled windows: when the subnet was re-registered inside the window, the count starts at its registration (generation) and a dissolved predecessor's registrations are left out. The window ends at meta.registrations_to_height. Null unless the decoded events span the window and reach within 100 blocks of meta.at (never a partial count).

pow_registrations_24hinteger · unit count · can be null

Successful proof-of-work register calls on this subnet in the 24 hours before meta.at (at any call depth: inside a batch or proxy too), current generation only; 0 when none (they are rare). Null with the matching registrations_*.

pow_registrations_7dinteger · unit count · can be null

Successful proof-of-work register calls on this subnet in the 7 days before meta.at (at any call depth: inside a batch or proxy too), current generation only; 0 when none (they are rare). Null with the matching registrations_*.

pow_registrations_30dinteger · unit count · can be null

Successful proof-of-work register calls on this subnet in the 30 days before meta.at (at any call depth: inside a batch or proxy too), current generation only; 0 when none (they are rare). Null with the matching registrations_*.

weightsobject

Weight setting: activity cutoff, rate limit, commit-reveal.

8 fields in weights
activity_cutoff_blocksinteger · unit blocks · can be null

Blocks without setting weights after which a validator is no longer active: since runtime v423 max(1, activity_cutoff_factor_milli x tempo / 1000), the value the runtime uses. Null when not readable.

activity_cutoff_factor_milliinteger · unit coefficient · can be null

The activity cutoff in thousandths of a tempo (SubtensorModule.ActivityCutoffFactorMilli; the runtime default when not stored). Null when not readable.

set_rate_limit_blocksstring · unit blocks · can be null

Blocks between two weight sets of a UID (SubtensorModule.WeightsSetRateLimit; the runtime default when not stored). Null when not readable.

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

Minimum weights per set (SubtensorModule.MinAllowedWeights; the runtime default when not stored). Null when not readable.

max_limit_ratiostring · unit ratio · 6 decimals · can be null

The largest weight one UID may give (u16 / 65535), a ratio, 6 decimals (SubtensorModule.MaxWeightsLimit; the runtime default when not stored). Null when not readable.

Format: decimal number, as a string
version_keystring · unit id · can be null

The weights version validators must send (a u64 identifier) (SubtensorModule.WeightsVersionKey; the runtime default when not stored). Null when not readable.

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

Whether weights are commit-reveal (SubtensorModule.CommitRevealWeightsEnabled; the runtime default when not stored). Null when not readable.

reveal_period_epochsstring · unit count · can be null

Epochs between a weight commit and its reveal (SubtensorModule.RevealPeriodEpochs; the runtime default when not stored). Null when not readable.

Format: whole number, as a string
consensusobject

Yuma consensus: kappa, rho, liquid alpha, bonds.

12 fields in consensus
kappa_ratiostring · unit ratio · 6 decimals · can be null

The consensus majority threshold (u16 / 65535), a ratio, 6 decimals (SubtensorModule.Kappa; the runtime default when not stored). Null when not readable.

Format: decimal number, as a string
rhointeger · unit coefficient · can be null

The consensus sigmoid's steepness (SubtensorModule.Rho; the runtime default when not stored). Null when not readable.

max_allowed_validatorsinteger · unit count · can be null

Validator permits on the subnet (SubtensorModule.MaxAllowedValidators; the runtime default when not stored). Null when not readable.

liquid_alpha_enabledboolean · can be null

Whether liquid alpha is on (SubtensorModule.LiquidAlphaOn; the runtime default when not stored). Null when not readable.

alpha_low_ratiostring · unit ratio · 6 decimals · can be null

Liquid alpha's low bound (u16 / 65535), a ratio, 6 decimals (SubtensorModule.AlphaValues; the runtime default when not stored). Null when not readable.

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

Liquid alpha's high bound (u16 / 65535), a ratio, 6 decimals (SubtensorModule.AlphaValues; the runtime default when not stored). Null when not readable.

Format: decimal number, as a string
alpha_sigmoid_steepnessinteger · unit coefficient · can be null

Liquid alpha's sigmoid steepness (SubtensorModule.AlphaSigmoidSteepness; the runtime default when not stored). Null when not readable.

bonds_moving_average_ratiostring · unit ratio · 6 decimals · can be null

The bonds' moving-average factor, a ratio, 6 decimals (SubtensorModule.BondsMovingAverage; the runtime default when not stored). Null when not readable.

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

The bonds penalty (u16 / 65535), a ratio, 6 decimals (SubtensorModule.BondsPenalty; the runtime default when not stored). Null when not readable.

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

Whether bonds reset is on (SubtensorModule.BondsResetOn; the runtime default when not stored). Null when not readable.

yuma3_enabledboolean · can be null

Whether Yuma3 consensus is on (SubtensorModule.Yuma3On; the runtime default when not stored). Null when not readable.

mechanism_countinteger · unit count · can be null

The subnet's mechanisms (sub-subnets) (SubtensorModule.MechanismCountCurrent; the runtime default when not stored). Null when not readable.

serving_rate_limit_blocksstring · unit blocks · can be null

Blocks between two axon / prometheus updates (SubtensorModule.ServingRateLimit; the runtime default when not stored). Null when not readable.

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

Whether stake transfers on the subnet are allowed (SubtensorModule.TransferToggle; the runtime default when not stored). Null when not readable.

subtoken_enabledboolean · can be null

Whether the subnet's alpha token is enabled (staking open) (SubtensorModule.SubtokenEnabled; the runtime default when not stored). Null when not readable.

defaulted_itemsarray of string

The hyperparameters with no stored value, where the runtime default is served, by the source's storage column name (e.g. kappa, rho, max_burn). [] when every value is stored. Clients must accept names not documented yet.

neuronsobject · can be null

Only with include=neurons, else null; head only (null off the head). The metagraph counts and the last epoch's emission (the full list is /subnets/{netuid}/metagraph).

9 fields in neurons
neuronsinteger · unit count

Registered UIDs (SubnetworkN).

validatorsinteger · unit count

UIDs holding a validator permit.

active_validatorsinteger · unit count

UIDs holding a validator permit that set weights within the activity cutoff.

minersinteger · unit count

UIDs without a validator permit.

active_minersinteger · unit count

Miners (UIDs without a validator permit) with incentive above 0 in the last epoch, in ANY of the subnet's incentive mechanisms (mechanism 0 only on an older data version's answer: see active_miners_is_lower_bound).

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

Alpha the last epoch paid the subnet's UIDs (sum of Emission), in alpha rao.

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

SubtensorModule.MaxAllowedUids: the subnet's UID capacity, the storage default when the subnet has no key. Never null: an older answer with include=neurons cannot be served (502).

mechanism_countinteger · unit count · can be null

SubtensorModule.MechanismCountCurrent: the incentive mechanisms the subnet runs, 1 when unset. Null on an older answer.

active_miners_is_lower_boundboolean · can be null

True when active_miners may miss miners (it counted mechanism 0 only). False when every mechanism is counted; null on an older answer, where a subnet with several mechanisms can only be shown as at least active_miners.

holdersobject · can be null

Only with include=holders, else null: the alpha holders (by coldkey), the top-10 share and the Nakamoto coefficient at the end of the latest closed UTC day at or before meta.at (also off the head), with the counts 7 and 30 days earlier. Null too until that day is available (none was on 2026-10-01).

12 fields in holders
daystring (date) · can be null

The UTC day the figures are for: the latest closed day whose last block is at or before meta.at (never the forming day). Every member is read at day_end_height.

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

The day's last block: the figures' block.

holdersinteger · unit count · can be null

Coldkeys holding alpha > 0 on the subnet (an account's positions under several hotkeys count once: the owner of the stake, not the hotkey).

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

Their alpha together, in alpha rao: each position floored, as the runtime pays it out.

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

The 10 largest holders' share of alpha_rao, a ratio with 6 decimals (0..1). Null when alpha_rao is 0.

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

The fewest holders (coldkeys) that together hold more than half of alpha_rao.

hhi_ratiostring · unit ratio · 6 decimals · can be null

How concentrated the holdings are: the normalised Herfindahl-Hirschman index (sum of s_i^2 - 1/N) / (1 - 1/N), with s_i each coldkey's share of alpha_rao and N = holders. A ratio 0..1 with 6 decimals: 0 = spread evenly, 1 = one holder (also 1 when there is only one). Derived. Null when the day has no holder.

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

holders on day - 7. Null until the daily history reaches that day, and when that day's end is before the current life (life_start_height): never a predecessor's figure.

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

alpha_rao on day - 7, in alpha rao. Null until the daily history reaches that day, and when that day's end is before the current life.

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

holders on day - 30. Null until the daily history reaches that day, and when that day's end is before the current life.

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

alpha_rao on day - 30, in alpha rao. Null until the daily history reaches that day, and when that day's end is before the current life.

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

Hotkeys whose pool on the subnet holds a NON-ZERO share from a coldkey other than the hotkey's Owner (null on an older data version's answer): the validators other people delegate to. The holders history's delegate_count (GET /subnets/{netuid}/holders/daily) counts the same (on an older data version's answer: hotkeys with any staker), per closed day. Read at the head, unlike the other members (which are at day): null off the head.

yieldobject · can be null

Only with include=yield, else null: the stakers' yield in ALPHA (the pools' value-per-share growth, net of the validator's take, alpha-weighted over pools of at least 1 alpha and annualised once; negative when the value per share fell; not a TAO or USD return) at the end of the latest closed UTC day at or before meta.at (also off the head): 1 / 7 / 30-day APYs, 7 / 30-day averages of the daily APY, its 30-day stability and a 90-day sparkline. Root reads 0 (its stakers' income arrives on other subnets and as basket entitlements). Null too until a day is available.

15 fields in yield
daystring (date)

The UTC day the figures are for: the latest closed day whose last block is at or before meta.at (never the forming day).

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

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

apy_1d_ratiostring · unit ratio · 6 decimals · can be null

The stakers' yield over the last UTC day ending at day, annualised once: per pool (a hotkey on this subnet holding at least 1 alpha), its growth g = i_day / i_(day-1) - 1 with i its value per share (TotalHotkeyAlpha / TotalHotkeyShares at a UTC day's end); the mean of g over the subnet's pools weighted by each pool's alpha at day; then (1 + mean)^(365) - 1. A ratio with 6 decimals (0.25 = 25 % a year), negative when the pools' value per share fell (never below -1; see SubnetYield). Null when no pool has a value on both ends of the window. Noisy: dividends land per tempo (~72 min), so a day holds a varying number of them; avg_7d_ratio and apy_7d_ratio are steadier. Null when the window starts before the current life's first whole UTC day (a re-registered slot's earlier life never counts). Null on the first available day.

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

The stakers' yield over the 7 UTC days ending at day, annualised once: per pool (a hotkey on this subnet holding at least 1 alpha), its growth g = i_day / i_(day-7) - 1 with i its value per share (TotalHotkeyAlpha / TotalHotkeyShares at a UTC day's end); the mean of g over the subnet's pools weighted by each pool's alpha at day; then (1 + mean)^(365/7) - 1. A ratio with 6 decimals (0.25 = 25 % a year), negative when the pools' value per share fell (never below -1; see SubnetYield). Null when no pool has a value on both ends of the window. Null until the daily history reaches back 7 days (and so on every subnet early on). Null when the window starts before the current life's first whole UTC day (a re-registered slot's earlier life never counts).

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

The stakers' yield over the 30 UTC days ending at day, annualised once: per pool (a hotkey on this subnet holding at least 1 alpha), its growth g = i_day / i_(day-30) - 1 with i its value per share (TotalHotkeyAlpha / TotalHotkeyShares at a UTC day's end); the mean of g over the subnet's pools weighted by each pool's alpha at day; then (1 + mean)^(365/30) - 1. A ratio with 6 decimals (0.25 = 25 % a year), negative when the pools' value per share fell (never below -1; see SubnetYield). Null when no pool has a value on both ends of the window. Null until the daily history reaches back 30 days (and so on every subnet early on). Null when the window starts before the current life's first whole UTC day (a re-registered slot's earlier life never counts).

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

Mean of the daily apy_1d_ratio over the 7 days ending at day, 6 decimals; negative when the days are. Null unless all 7 days have one. The current life's whole days only (null when fewer).

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

Mean of the daily apy_1d_ratio over the 30 days ending at day, 6 decimals; negative when the days are. Null unless all 30 days have one. The current life's whole days only (null when fewer).

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

Sample standard deviation of the daily apy_1d_ratio over the 30 days ending at day (in the same ratio units; lower = steadier), 6 decimals. Null unless all 30 days have one. The current life's whole days only (null when fewer).

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

Share (0..1, 6 decimals) of the subnet's alpha in pools of at least 1 alpha at day whose pools stand behind apy_1d_ratio (a value per share on both day ends). 0 when none does (then apy_1d_ratio is null).

Format: decimal number, as a string
yield_from_daystring (date) · can be null

The current life's first day with a yield: its first staked pool, from its first emission (a newly registered subnet earns nothing until it is started), so the yield figures are null before it and a 30-day figure needs 30 days from here. Null on an older data-source answer that does not state it.

Format: date, YYYY-MM-DD
not_startedboolean · can be null

True while the current life has not started emitting (no FirstEmissionBlockNumber on chain; a life registered before v257, block 5,228,683, counts as started from its registration): then yield_from_day and every yield figure are null, not 0. False once it has. Null on an older data-source answer that does not state it.

sparkline_90d_from_daystring (date) · can be null

The first day of sparkline_90d: the oldest available day in the 90 days ending at day (89 days before it once the history is long enough), never before the current life's first whole UTC day.

Format: date, YYYY-MM-DD
sparkline_90darray of string · unit ratio · 6 decimals · can be null

The daily apy_1d_ratio over the 90 days ending at day, oldest first, from sparkline_90d_from_day: one entry per available day (a day without data is absent, not null), null where that day's apy_1d_ratio is, 6 decimals, signed. The current life's days only.

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

apy_7d_ratio as it stood 7 days before day (the same figure for the 7 days ending then), 6 decimals, signed: compare the two for the trend. Null when that day has none, on an older data-source answer that does not carry it, and when its window starts before the current life's first whole UTC day.

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

The subnet's 30-day staking APY as it stood 7 days before day (the trend of apy_30d_ratio), an apy RatioFigure over the 30 days to day - 7 (checked): a value only when all 30 days of that window are available, else insufficient_history with days_ok saying how far it got. Null on an answer read before the source served it. days_ok counts the current life's days only (insufficient_history when the window starts before the life).

7 fields in apy_30d_7d_ago
valuestring · unit ratio · can be null

The figure, a signed ratio (1 = 100 %). Null exactly when unavailable_reason is set, and served only when days_ok = days_expected (checked).

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

apy: a compounded annual rate; apr: a simple annual rate; period: an un-annualised return or change over the window. New values may be added; show an unknown value as is (or generically).

from_daystring (date) · can be null

The window opens at this UTC day's end (to_day - days_expected). Null only with not_ready or not_applicable.

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

The window closes at this UTC day's end: the block's as_of_day, at or before meta.at's day. Null with from_day.

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

Whole UTC days of the window whose inputs are valid, 0..days_expected: how far a figure short of its window (insufficient_history) has got. Null with from_day.

days_expectedinteger · unit count

The nominal window in days: 7 or 30.

unavailable_reasonstring · can be null

Why value is null (each figure may give only the reasons its block lists, checked; no_deposits, nothing was ever deposited, only on a fund's lifetime_return); null exactly when value is given. Known values: not_ready, insufficient_history, not_applicable, no_root_uid, lost_root_uid_in_window, sell_gate_closed, fund_empty, fund_dissolved, fund_reset, share_collapse, dust_fund, provisional, unpriced_holding, no_nav_row, no_pool, pool_not_alive, no_permit, pool_refused, pool_unpriced, amount_too_large, below_min_stake, hotkey_not_on_root, nothing_owed, deposit_model_pending, swap_refused, price_unknown, no_deposits. New values may be added; treat unknown values as unavailable.

emissionobject · can be null

Only with include=emission, else null: the alpha the subnet's emission credited on the latest closed UTC day at or before meta.at (also off the head), over 1 / 7 / 30 days, and the day's split by component (nominator dividends, validator take, miner incentive, owner cut, root take and claimable, basket flush). Null on root (no alpha emission of its own) and until a day is available.

5 fields in emission
daystring (date)

The last UTC day of the windows: the latest closed day at or before meta.at (never the forming day). The 1 / 7 / 30-day sums end with it.

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

Alpha of this subnet credited on day by its emission steps (exact per step, from the emission credits), in alpha rao: the sum of by_component_1d_rao.

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

The same over the 7 days ending at day, in alpha rao. Null until the history reaches back 7 days. Floored at the current life's first whole UTC day (a younger life: its days so far).

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

The same over the 30 days ending at day, in alpha rao. Null until the history reaches back 30 days (the credits start on 2026-09-06). Floored at the current life's first whole UTC day (a younger life: its days so far).

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

alpha_1d_rao split by recipient component, in alpha rao: nominator_dividend (paid into the validators' pools), validator_take, miner_incentive, owner_cut, root_take, root_claimable_queued (the root stakers' dividends, queued as claimable) and basket_flush_credit. An open map: only components credited that day appear, and clients must accept components not documented yet.

price_sourcestring

Where price_tao comes from: pool_spot, the pool's spot price at meta.at (the runtime's current alpha price from the reserves; the only value served today), or last_trade, the last trade's execution price (reserved for a market without a pool price). Never null. New values may be added; show an unknown value as is (or generically).

emission_share_1d_ratiostring · unit ratio · 8 decimals · can be null

The subnet's share of the network's TAO emission on the latest closed UTC day at or before meta.at: its SubnetTaoInEmission summed over that day / every subnet's that day. A ratio 0..1 with 8 decimals; derived. Null when the subnet has no TAO emission row that day (root; a subnet registered since, or one the network emitted no TAO into) and while no day is available. The injected-TAO share only: the share of the whole block emission (the chain's excess buy included) is share_of_block_emission_ratio.

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

The subnet's share of the WHOLE block emission on emission_share_1d_ratio's day: (the TAO injected into its pool + the chain's excess buy for it) / the same summed over every subnet (/subnets/{netuid}/emission-share's rule, from the protocol flows). Differs from emission_share_1d_ratio, which is the injected TAO only (SubnetTaoInEmission): a subnet whose emission is partly the chain's buy has a larger share here. A ratio 0..1 with 8 decimals; the rows sum to 1 within rounding. Null on root, unless the protocol flows cover the subnet's whole day (never a partial day), and on an older answer.

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

Rank of the subnet's TAO emission on that same day among every subnet with one (1 = the largest; equal emissions share a rank). Null with emission_share_1d_ratio.

emission_rank_30d_agointeger · unit count · can be null

The slot's emission_rank on the day 30 days before that day (the slot's rank then, whichever generation held it). Null until the daily history reaches back 30 days, and when the slot had no TAO emission row that day.

price_return_30d_ratiostring · unit ratio · 6 decimals · can be null

price_tao / the price at the last block at or before meta.at - 30 d - 1: the alpha price's 30-day return in TAO, a signed ratio with 6 decimals (0.05 = +5 %); derived, the same figure as price_change_30d_ratio. Null when that block is before the pool history or the slot then held another generation (a subnet younger than 30 days): never across subnet lifetimes.

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

The stakers' 30-day return in alpha: (1 + the 30-day APY)^(30/365) - 1, the APY being yield.apy_30d_ratio of the latest available yield day at or before meta.at (read whether or not include=yield is asked). A signed ratio with 8 decimals; derived, not a TAO return. Null when the 30-day APY is null (the yield history does not reach back 30 days) or price_return_30d_ratio is.

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

Holding staked alpha for 30 days, in TAO: (1 + price return) x (1 + yield_return_30d_ratio) - 1, the price return taken unrounded. A signed ratio with 8 decimals; derived. Null when either part is.

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

The 30-day yield return annualised simply, without compounding: ((1 + the 30-day APY)^(30/365) - 1) x 365 / 30. A signed ratio with 8 decimals (0.12 = 12 % a year); derived, in alpha. Null when the 30-day APY is null (the yield history does not reach back 30 days); unlike yield_return_30d_ratio it does not need the 30-day price. Null when the 30-day window starts before the current life's first whole UTC day.

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

Value locked in the pool, in rao of TAO: 2 x pool_tao_rao (the TAO reserve plus the alpha reserve at the pool's own price, which equals it); on root alpha_out_rao (root alpha is TAO). Derived. Null only when the reserve is not recorded.

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

SubtensorModule.RootProp of the subnet at meta.at: the stored I96F32 fixed-point value / 2^32, a decimal string with 12 decimals (the runtime's root proportion for the subnet, as the chain states it). Head only: null off the head (an at below the pool dataset's head), and null where the chain has no entry (root).

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

Pool buys - sells over the 7 d before meta.at (this generation's hourly buckets, from the start of the hour 7 d back): net TAO into the pool by swaps, signed, in rao (negative = net outflow); emissions are not flows and are left out; 0 when none. Null when the pool dataset's coverage does not reach the window's start and this generation began before coverage (the sum would miss blocks: never a partial sum); a generation registered inside coverage has its whole window and is served.

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

The same over the 30 d before meta.at, signed, in rao; 0 when none. Null when the pool dataset's coverage does not reach the window's start and this generation began before coverage (the sum would miss blocks: never a partial sum); a generation registered inside coverage has its whole window and is served.

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

Net new alpha over the last 50,400 blocks (~7 d) relative to the effective supply: [(SubnetAlphaIn + SubnetAlphaOut) at meta.at - the same 50,400 blocks earlier - the alpha burned in between (AlphaBurned's increases)] / (alpha_out_rao - alpha_burned_rao). A signed ratio with 8 decimals; derived, within the current generation. Null on root, off the head (the burn counter is read at the head only), when the subnet was registered inside the window or the pool history does not reach its start, when the burned counter's history does not cover it, and when the effective supply is 0.

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

Only with include=buyback, else null: the owner's GROSS POOL BUYS, TAO the subnet owner's coldkey (SubnetOwner at the head, applied to the whole window) spent buying this subnet's alpha through the pool over the 30 d before meta.at (its buys in the trade history, whatever it did with the alpha), in rao; 0 when none. The window starts no earlier than the life's first block, so it never exceeds owner_pool_buys_lifetime_tao_rao (checked). Not the burn buyback (owner_buyback_burn_30d_tao_rao). The new name of the deprecated owner_buyback_30d_tao_rao. Null when the pool dataset's coverage does not reach the window's start and this generation began before coverage (the sum would miss blocks: never a partial sum); a generation registered inside coverage has its whole window and is served.

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

Only with include=buyback, else null: the alpha those same 30-day pool buys bought (the window floored at the life's first block), in alpha rao; 0 when none; never above owner_pool_buys_lifetime_alpha_rao (checked). Null with owner_pool_buys_30d_tao_rao (never a partial sum) and on an older data version's answer.

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

Only with include=buyback, else null: owner_pool_buys_30d_alpha_rao / the owner cut emitted to the subnet owner over the same 30 days (alpha / alpha), 6 decimals: how much of what the owner earned it bought back through the pool. Above 1 when it bought more than it earned. Null without the 30-day alpha, when no owner cut was emitted in the window, and on an older data version's answer.

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

Only with include=buyback, else null: TAO the CURRENT owner coldkey spent buying this subnet's alpha through the pool since owner_pool_buys_lifetime_from_height (its gross buys), in rao; 0 when none. Not the subnet's whole life when the trade history starts later (see owner_pool_buys_lifetime_from_height). Null on an older data version's answer.

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

Only with include=buyback, else null: the alpha those lifetime pool buys bought, in alpha rao; 0 when none. Null on an older data version's answer.

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

Only with include=buyback, else null: where the lifetime pool buys start, the later of the trade history's first block and the life's first block (life_start_height). Null on an older data version's answer.

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

Only with include=buyback, else null: the owner's BURN BUYBACK, TAO the CURRENT owner coldkey staked through add_stake_burn on this subnet's current life in the 30 d before meta.at (SubtensorModule.AddStakeBurn events whose extrinsic it signed; the alpha bought is burned), in rao; 0 when none. A part of owner_buyback_burn_lifetime_tao_rao (checked). The gross pool buys are owner_pool_buys_*. Null on an older answer.

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

Only with include=buyback, else null: the alpha those 30-day add_stake_burn calls bought and burned, in alpha rao; 0 when none; never above owner_buyback_burn_lifetime_alpha_rao (checked). Null on an older answer.

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

Only with include=buyback, else null: the same TAO since the current life's first block (life_start_height; chain events, complete wherever blocks are decoded), in rao; 0 when none. Null on an older answer.

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

Only with include=buyback, else null: the alpha burned by those lifetime calls, in alpha rao; 0 when none. Null on an older answer.

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

Only with include=buyback, else null: the add_stake_burn calls by the current owner coldkey since the life's first block (0: the two lifetime amounts are 0, checked). Null on an older answer.

owner_buyback_30d_tao_raostring · unit rao (÷1e9) · can be null · beta · deprecated

Deprecated: the former name of owner_pool_buys_30d_tao_rao (the GROSS pool buys: every buy of this subnet's alpha by the current owner coldkey through the pool), served alongside it with the SAME value for one data version (checked equal; null exactly when it is: without include=buyback, and as the twin states). Not the burn: the owner's add_stake_burn buyback is owner_buyback_burn_*. Deprecated: use owner_pool_buys_30d_tao_rao; sunset 2027-02-15.

Format: whole number, as a string · on chain: u64
Deprecated since 2026-10-04, removed after 2027-02-15. Use owner_pool_buys_30d_tao_rao instead.
owner_buyback_30d_alpha_raostring · unit alpha_rao (÷1e9) · can be null · beta · deprecated

Deprecated: the former name of owner_pool_buys_30d_alpha_rao (the GROSS pool buys: every buy of this subnet's alpha by the current owner coldkey through the pool), served alongside it with the SAME value for one data version (checked equal; null exactly when it is: without include=buyback, and as the twin states). Not the burn: the owner's add_stake_burn buyback is owner_buyback_burn_*. Deprecated: use owner_pool_buys_30d_alpha_rao; sunset 2027-02-15.

Format: whole number, as a string · on chain: u64
Deprecated since 2026-10-04, removed after 2027-02-15. Use owner_pool_buys_30d_alpha_rao instead.
owner_buyback_share_of_owner_cut_30d_ratiostring · unit ratio · 6 decimals · can be null · beta · deprecated

Deprecated: the former name of owner_pool_buys_share_of_owner_cut_30d_ratio (the GROSS pool buys: every buy of this subnet's alpha by the current owner coldkey through the pool), served alongside it with the SAME value for one data version (checked equal; null exactly when it is: without include=buyback, and as the twin states). Not the burn: the owner's add_stake_burn buyback is owner_buyback_burn_*. Deprecated: use owner_pool_buys_share_of_owner_cut_30d_ratio; sunset 2027-02-15.

Format: decimal number, as a string
Deprecated since 2026-10-04, removed after 2027-02-15. Use owner_pool_buys_share_of_owner_cut_30d_ratio instead.
owner_buyback_lifetime_tao_raostring · unit rao (÷1e9) · can be null · beta · deprecated

Deprecated: the former name of owner_pool_buys_lifetime_tao_rao (the GROSS pool buys: every buy of this subnet's alpha by the current owner coldkey through the pool), served alongside it with the SAME value for one data version (checked equal; null exactly when it is: without include=buyback, and as the twin states). Not the burn: the owner's add_stake_burn buyback is owner_buyback_burn_*. Deprecated: use owner_pool_buys_lifetime_tao_rao; sunset 2027-02-15.

Format: whole number, as a string · on chain: u64
Deprecated since 2026-10-04, removed after 2027-02-15. Use owner_pool_buys_lifetime_tao_rao instead.
owner_buyback_lifetime_alpha_raostring · unit alpha_rao (÷1e9) · can be null · beta · deprecated

Deprecated: the former name of owner_pool_buys_lifetime_alpha_rao (the GROSS pool buys: every buy of this subnet's alpha by the current owner coldkey through the pool), served alongside it with the SAME value for one data version (checked equal; null exactly when it is: without include=buyback, and as the twin states). Not the burn: the owner's add_stake_burn buyback is owner_buyback_burn_*. Deprecated: use owner_pool_buys_lifetime_alpha_rao; sunset 2027-02-15.

Format: whole number, as a string · on chain: u64
Deprecated since 2026-10-04, removed after 2027-02-15. Use owner_pool_buys_lifetime_alpha_rao instead.
owner_buyback_lifetime_from_heightinteger · unit block · can be null · beta · deprecated

Deprecated: the former name of owner_pool_buys_lifetime_from_height (the GROSS pool buys: every buy of this subnet's alpha by the current owner coldkey through the pool), served alongside it with the SAME value for one data version (checked equal; null exactly when it is: without include=buyback, and as the twin states). Not the burn: the owner's add_stake_burn buyback is owner_buyback_burn_*. Deprecated: use owner_pool_buys_lifetime_from_height; sunset 2027-02-15.

Deprecated since 2026-10-04, removed after 2027-02-15. Use owner_pool_buys_lifetime_from_height instead.
alpha_burned_supply_ratiostring · unit ratio · 8 decimals · can be null · beta

Only with include=buyback, else null: alpha_burned_rao (AlphaBurned, cumulative since runtime v411, not lifetime) / alpha_issuance_rao, 8 decimals: the share of the subnet's alpha issuance burned. Checked against those two members. Null on root, without the burned counter, and on an older answer.

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

The data source's daily figure: 1 - TAO back / the reference stake, from the runtime's own swap simulation at the latest UTC day end at or below meta.at (meta.reference_stake.height): buy the reference stake, sell the alpha back against the same pool state. A fraction of one, 8 decimals; root 0. Null until that day's simulation ran (~2 h after the day end), and for a subnet it did not simulate. At another block than cost_model (computed by this API at state.pool.state_height).

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

The data source's daily figure: 1 - alpha out x spot / the reference stake, with spot the pool's stored price at that day end in whole rao per alpha (so it can differ from cost_model.entry_cost_ratio in the 7th decimal even at the same block). 8 decimals; root 0; null as round_trip_cost_ratio.

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

The data source's daily figure: 1 - TAO back / (alpha out x spot), spot as in entry_cost_ratio. 8 decimals; root 0; null as round_trip_cost_ratio.

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

Why the data source's three daily cost ratios are null: staking_disabled (SubtokenEnabled is false: the chain refuses stakes and unstakes there; for a past at, the value stored with that day's simulation) or not_simulated (no simulation for that day). Null exactly when the ratios are served (root's are 0). Null on every row of an older data version's answer, which does not state a reason. New values may be added; treat unknown values as unavailable.

emission_share_7d_ago_ratiostring · unit ratio · 8 decimals · can be null

emission_share_1d_ratio's rule on the UTC day 7 days before its day (null on an older data version's answer), a ratio 0..1 with 8 decimals: with emission_share_1d_ratio, the 7-day change of the subnet's emission share. Null until the daily history reaches that day (it starts 2026-09-27), and when that day is not a whole day of the current life.

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

TAO recycled by neuron registrations over the 24 h to meta.at, this generation only: the increases of SubtensorModule.RAORecycledForRegistration (null on an older data version's answer), in rao. Null when the counter history does not cover the window (never a partial sum).

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

Computed by this API: the 24 h price change in USD, price_tao x meta.tao_usd / (price_24h_ago_tao x meta.tao_usd_24h_ago) - 1, a signed ratio with 6 decimals (0.05 = +5 %): the subnet's move and TAO's together, where price_change_24h_ratio is the move in TAO alone. Null when any of the four is null or the price 24 h ago is 0 (never across a re-registration, as price_24h_ago_tao), and on an older data version's answer (no meta.tao_usd_24h_ago).

Format: decimal number, as a string · can be negative
market_cap_ex_burned_spot_usdstring · unit usd · 6 decimals · can be null · beta

Computed by this API: market_cap_ex_burned_spot_tao_rao in USD at meta.tao_usd, 6 decimals (half away from zero): the alpha market cap without the burned alpha. Null when either is.

Format: decimal number, as a string
market_cap_circulating_spot_usdstring · unit usd · 6 decimals · can be null · beta

Computed by this API: market_cap_circulating_spot_tao_rao in USD at meta.tao_usd, 6 decimals (half away from zero): the cap of the alpha accounts hold. Null when either is.

Format: decimal number, as a string
cost_modelobject

Computed by this API (not in the data source's answer): the round-trip, entry and exit cost of the reference stake (meta.reference_stake) from state.pool's raw inputs at state_height, with the chain's swap reimplemented exactly (Balancer and stable curves). Always an object; its figures are null with an unavailable_reason (no_state without include=state).

10 fields in cost_model
round_trip_cost_ratiostring · unit ratio · 8 decimals · can be null

1 - tao_back_rao / reference_stake_tao_rao: what staking the reference stake and unstaking the alpha it buys costs, both legs against the pool at state_height (fees and slippage), a fraction of one, 8 decimals (half up). 0 on a stable subnet. Null with unavailable_reason.

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

1 - alpha_out_rao x spot / reference_stake_tao_rao: the stake's loss against the pool's spot price (the fee and the buy's slippage), with spot the Balancer price (w_alpha / w_tao) x TAO reserve / alpha reserve at state_height, exact. 8 decimals; 0 on a stable subnet. Null with unavailable_reason.

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

1 - tao_back_rao / (alpha_out_rao x spot): the unstake's loss against spot (the fee and the sell's slippage). 8 decimals; 0 on a stable subnet. (1 - entry) x (1 - exit) = 1 - round trip. Null with unavailable_reason.

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

The TAO staked, rao: meta.reference_stake.tao_rao (the 30-day median real stake-add). Null without one.

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

The alpha the reference stake buys, alpha rao of this subnet (after the fee). Null with unavailable_reason.

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

The TAO that alpha sells back for against the same pool state, rao (after the fee). Null with unavailable_reason.

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

The block of the pool inputs the figures are computed from (state.pool.state_height). Null without state.

mechanismstring · can be null

The curve modelled (state.pool.swap_mechanism). Null without state. Known values: stable, constant_product, concentrated_liquidity, balancer. New values may be added; show an unknown value as is (or generically).

sourcestring

Always model: computed by this API from the raw chain inputs. The data source's own figures (the runtime's simulation at the latest day end) are the subnet's round_trip_cost_ratio / entry_cost_ratio / exit_cost_ratio, at another block. New values may be added; show an unknown value as is (or generically).

unavailable_reasonstring · can be null

Why every figure is null; null when they are given. One of no_state (state is null: include=state not asked, or an at off the head), mechanism_unknown (swap_mechanism null), unsupported_mechanism (constant_product or concentrated_liquidity: only the balancer and stable curves are modelled), inputs_missing (a reserve, the fee rate or the Balancer weight is null or out of range), no_reference_stake (no reference stake to cost), subtoken_disabled (hyperparams.subtoken_enabled is false, or the row's cost_unavailable_reason is staking_disabled: the chain refuses stakes and unstakes there) or swap_refused (the chain would refuse this swap: no output, or a net input over 1000 x the input reserve). New values may be added; treat unknown values as unavailable.

metaobject · can be null

bittensor.ai's own content for this subnet (include=meta; null without it): the display name and logo with their precedence, tags, the owner's published brand colours and tagline, the repository and display-ready text. Joined by netuid AND generation: content stamped with another registration of the slot is never served, and this whole object is null when the slot's record belongs to another registration.

17 fields in meta
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 content 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.

namestring · can be null

The name to display: a bittensor.ai admin override, else the on-chain identity name (the row's name), else the name from the subnet's GitHub sync. Null when none is known.

name_sourcestring · can be null

Where name came from. Null when name is null. Known values: admin, chain, github. New values may be added; show an unknown value as is (or generically).

logo_urlstring · can be null

The logo to render: the subnet identity's logo (identity.logo_url, this life's): 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.

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.

logo_url_cachedstring · can be null

bittensor.ai's cached copy of the on-chain identity's logo (served from our CDN), only while the live identity still points at the image it was copied from. Null otherwise.

tagsarray of string · can be null

Topic tags curated for this registration (the subnet directory's filters). [] when it has none; null when bittensor.ai has no record of this registration, or its tags cannot be read right now.

taglinestring · can be null

The owner's published tagline on bittensor.ai, raw (this registration only). Null when none.

brand_colorstring · can be null

The owner's published primary brand colour, #rrggbb (this registration only). Null when none.

brand_color_secondarystring · can be null

The owner's published secondary brand colour, #rrggbb. Null when none.

brand_color_accentstring · can be null

The owner's published accent colour, #rrggbb. Null when none.

repo_urlstring · can be null

The GitHub repository served for this registration (https://github.com/o/r), the same one GET /api/v2/subnets/{netuid}/repo serves: the owner's claim for this life, else the on-chain identity's, else bittensor.ai's registry's (repo_source). Null when none.

repo_sourcestring · can be null

Which source chose repo_url: owner_claim (the owner's bittensor.ai page for this life), chain_identity (the live on-chain identity), registry (bittensor.ai's curated registry). Null with repo_url. New values may be added; show an unknown value as is (or generically).

display_textobject

Display-ready text: cleaned, slot-sized tagline (the owner's published tagline first) and summary of the description (an admin override, else the on-chain identity's), never a cut word.

7 fields in display_text
taglinestring · can be null

One-line tagline: ONE sentence of at most 90 characters, never shortened. Source priority: the owner's published customization tagline (current registration only), else the description when it is already one sentence of at most 90 characters (for text joined by | , its first part). Null rather than a cut paragraph.

tagline_sourceenum · can be null

Where tagline came from. An opaque identifier of where it came from: owner (the subnet owner's published customization on bittensor.ai, current registration only), admin (a bittensor.ai admin override), chain (the on-chain subnet identity, SubnetIdentitiesV3) or derived (taken from the subnet's description). Null when tagline is null.

One of: owner, admin, chain, derived
descriptionstring · can be null

The full cleaned subnet description (admin override, else the on-chain identity description), never cut. Paragraph breaks are kept only when description_format is markdown. Null when there is none or it is a placeholder. The owner's own long write-up, when published, is owner_provided.description on the subnet detail.

description_formatenum · optional

markdown only when the description carries unmistakable markdown (a heading, code fence, link, bold text, a pipe-delimited grid, or two or more list lines); otherwise plain (the default), to be rendered as text.

One of: plain, markdown
description_sourceenum · can be null

Where description came from. An opaque identifier of where it came from: owner (the subnet owner's published customization on bittensor.ai, current registration only), admin (a bittensor.ai admin override), chain (the on-chain subnet identity, SubnetIdentitiesV3) or derived (taken from the subnet's description). Null when description is null.

One of: owner, admin, chain, derived
summarystring · can be null

Card-sized summary of at most 200 characters: the whole description when it fits, else its longest run of whole sentences from the start that fits. Null when no sentence boundary fits (never a cut sentence), and for a markdown description whose first paragraph is not plain text.

summary_sourceenum · can be null

Where summary came from: derived (an opaque identifier: taken from description) when summary is set; null otherwise.

One of: owner, admin, chain, derived
profileobject · can be null

Only with include=profile (or its deprecated spelling include=page) on GET /subnets/{netuid} (absent otherwise): bittensor.ai's own content, the owner's published subnet page (banner, description, links, team, owner-provided technical notes) and the cached on-chain logo, joined by netuid AND generation like meta. Every life of the slot keeps its own page and logo, so a row of an ended life (at inside it) carries that life's page. Null when there is neither a page of this registration nor a cached logo.

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: served with it whenever include=profile or include=page is asked (absent otherwise). 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
valuationobject · can be null

Only with include=valuation on GET /subnets/{netuid} (head only; absent otherwise): the alpha's USD Mayer multiple and power-law fair value in this generation, computed by this API from the subnet's UTC daily closes (one more data-source call, cached 300 s).

5 fields in valuation
price_usdstring · unit usd_per_alpha · 6 decimals · can be null

The latest daily bucket's close (the current UTC day so far), USD per alpha of this subnet, 6 decimals. Null without history.

Format: decimal number, as a string
price_daystring (date) · can be null

The UTC day of price_usd's bucket. Null without history.

Format: date, YYYY-MM-DD
history_daysinteger · unit days

Closed UTC daily closes the indicators were computed on (at most 1,000).

mayerobject

The Mayer multiple.

4 fields in mayer
ma_200d_price_usdstring · unit usd_per_alpha · 6 decimals · can be null

The simple mean of the last 200 closed UTC daily closes, USD per alpha of this subnet, 6 decimals. Null with unavailable_reason.

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

price_usd / ma_200d_price_usd, 6 decimals (1 = at the 200-day mean). Null with unavailable_reason.

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

The multiple's band: below_trend under 1, at_trend from 1 to under 2.4, overheated from 2.4 (Trace Mayer's bands). Null with unavailable_reason.

One of: below_trend, at_trend, overheated
unavailable_reasonstring · can be null

Null when the figures are given; else insufficient_history (fewer than 200 closed days, in this subnet generation for a subnet) or no_history (no daily close at all). Known values: insufficient_history, no_history, degenerate_fit. New values may be added; treat unknown values as unavailable.

power_lawobject

The power-law fair value.

8 fields in power_law
anchor_daystring (date) · can be null

Day 0 of the fit (UTC): TAO's mainnet genesis (2023-03-20) for TAO; for a subnet, the day before its current generation started (life_start_time's UTC day minus one, so the life's first day is day 1), tied to the life and not to the candle window; a re-registered slot is never fitted across two lives. Null without history.

Format: date, YYYY-MM-DD
days_since_anchorinteger · unit days · can be null

Days from anchor_day to price_day, the fit's x at which fair_value_price_usd is read.

coefficient_a_price_usdstring · unit usd_per_alpha · 6 decimals · can be null

The fit's a: the fitted price at day 1, USD per alpha of this subnet, 6 decimals. Null with unavailable_reason.

Format: decimal number, as a string
exponent_b_coefficientstring · unit coefficient · 6 decimals · can be null

The fit's exponent b (dimensionless, signed), 6 decimals. Null with unavailable_reason.

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

a x days_since_anchor^b: the fitted price at price_day, USD per alpha of this subnet, 6 decimals. Null with unavailable_reason.

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

price_usd / fair_value_price_usd - 1, a signed ratio, 6 decimals (-0.2 = 20 % under the fitted value). Null with unavailable_reason.

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

The fit's R² on the log-log points (0..1, 6 decimals). Fit quality within this series only: not comparable across subnets, whose histories start at different days. Null with unavailable_reason.

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

Null when the fit is given; else insufficient_history (fewer than 30 closed days after the anchor), no_history or degenerate_fit (no spread in days, or a fit that overflows). New values may be added; treat unknown values as unavailable.

halvingobject · can be null

Only with include=halving on GET /subnets/{netuid} (absent otherwise): the subnet's ALPHA halving schedule, computed by this API from this row's alpha_issuance_rao (no extra data-source call).

8 fields in halving
halvings_completedinteger · unit count · can be null

Halvings so far: floor(log2(21M / (21M - alpha issuance))). Null with unavailable_reason.

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

Alpha emitted per block to the subnet's participants now by the rule, in alpha rao. With include=state checked against state.pool.alpha_out_per_block_rao (a disagreement nulls every figure, emission_rule_mismatch).

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

Alpha emitted per block after the next halving, in alpha rao (half the current emission).

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

The alpha issuance at which the current emission period began (the last threshold).

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

The alpha issuance at which emission next halves, 21M x (1 - 2^-(halvings_completed + 1)) alpha.

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

next_halving_issuance_alpha_rao - the row's alpha_issuance_rao, in alpha rao.

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

True when the rule was checked against the chain's last emission (include=state, head only, and a subnet that has emitted); false otherwise (the figures are the runtime's rule all the same).

unavailable_reasonstring · can be null

Why every figure is null: not_applicable (root: its alpha is TAO 1:1, no alpha emission), no_issuance (alpha_issuance_rao not served: an older data-source answer), supply_cap (issuance at the 21M cap) or emission_rule_mismatch (the chain's last emission disagrees with the rule, or a threshold was crossed inside the last block). Null when the figures are served. New values may be added; treat unknown values as unavailable.

registrationobject · can be null · beta

Only with include=registration (absent otherwise): the registration and pruning parameters as chain state stores them (Burn, BurnHalfLife, BurnIncreaseMult, EMAPriceHalvingBlocks, ImmuneOwnerUidsLimit, MinAllowedUids, RootClaimableThreshold), the runtime's default where none is stored (defaulted_items). Read beside the subnet at meta.sections.registration.at. Null when that read is unavailable (meta.sections.registration.unavailable_reason) or did not carry this subnet.

8 fields in registration
burn_tao_raostring · unit rao (÷1e9) · can be null

Burn: the registration burn now, rao of TAO (what a burned registration costs at that block). Where the subnet stores no value the runtime's declared default is served and the member is named in defaulted_items; never null for that.

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

BurnHalfLife: the blocks over which the registration burn decays by half (floored at the subnet's min burn). Where the subnet stores no value the runtime's declared default is served and the member is named in defaulted_items; never null for that.

burn_increase_multstring · unit coefficient · can be null

BurnIncreaseMult (U64F64, exact decimal): the factor the burn is multiplied by on each registration. Where the subnet stores no value the runtime's declared default is served and the member is named in defaulted_items; never null for that.

Format: decimal number, as a string
ema_price_halving_blocksstring · unit blocks · can be null

EMAPriceHalvingBlocks (u64 as a decimal string): the half-life, in blocks, of the subnet's moving price. Where the subnet stores no value the runtime's declared default is served and the member is named in defaulted_items; never null for that.

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

ImmuneOwnerUidsLimit: how many of the owner's UIDs are immune from pruning. Where the subnet stores no value the runtime's declared default is served and the member is named in defaulted_items; never null for that.

min_allowed_uidsinteger · unit count · can be null

MinAllowedUids: the floor MaxAllowedUids can be set to. Where the subnet stores no value the runtime's declared default is served and the member is named in defaulted_items; never null for that.

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

RootClaimableThreshold (I96F32, exact decimal; alpha rao of this subnet; on root, rao of TAO): the least claimable root dividend a claim pays out. Where the subnet stores no value the runtime's declared default is served and the member is named in defaulted_items; never null for that.

Format: decimal number, as a string
defaulted_itemsarray of string

The members above with no stored value, where the runtime's default is served ([] when every one is stored).

tradesarray of objects · can be null

Only with include=trades: the subnet's newest child_limit pool trades, exactly the first page of GET /subnets/{netuid}/trades (meta.sections.trades).

25 fields in trades (each item)
heightinteger · unit block

Block of the trade.

event_indexinteger · unit id

Index of the trade's event in the block; never null. (height, event_index) identifies the row, with netuid for a basket claim that credits several subnets in one event.

extrinsic_indexinteger · unit id · can be null

Index of the extrinsic in the block; null for a trade made by a block hook.

timestring (date-time)

Timestamp of the block, RFC 3339 UTC with milliseconds.

Format: date and time, ISO 8601 in UTC
sidestring

buy (TAO into the pool, alpha out), sell (alpha in, TAO out), swap (alpha of netuid into alpha of counterpart_netuid, one row for both pools), basket_claim, basket_swap (basket rebalancing), registration, fee (alpha the transaction-fee extension sold, or bought back, to pay a fee charged in alpha, before or after the call's dispatch) or other. A fee row needs the call-path trace: it is classified only up to meta.coverage.fee_classified_to_height (~1.8 days behind the head on 2026-10-01). Above that height a fee paid in alpha still reads as a sell, and it becomes a fee row once the trace reaches it, so rows above it can still change side. Clients must accept values not documented yet.

netuidinteger · unit id

The pool: buy/sell/registration, the subnet traded; swap, the origin (sold) subnet.

counterpart_netuidinteger · unit id · can be null

Swap: the destination (bought) subnet. Null on every other side.

parent_event_indexinteger · unit id · can be null

Set on the extra legs of a multi-leg operation (e.g. a hotkey transfer across several subnets): the event_index of the leg it belongs with; group by it to show one action. Null on single-leg rows.

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

TAO into (buy) or out of (sell) the pool, in rao. On a swap, the TAO that passed between the two pools. Null when the trade moved no TAO (a basket claim credited in alpha).

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

Alpha of netuid out of (buy) or into (sell, swap) the pool, gross of the fee, in alpha rao. Null when not recorded for the side.

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

Swap: alpha of counterpart_netuid received, in alpha rao. Null on every other side.

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

tao_rao / alpha_rao from the gross amounts (TAO per alpha), 12 decimals. Null when either is null or 0.

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

The pool's runtime price (TAO per alpha) after the block, 12 decimals. Null when unknown.

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

Swap: the destination pool's runtime price after the block (TAO per alpha), 12 decimals. Null otherwise.

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

The pool's TAO reserve (SubnetTAO) after the block, in rao. Null when unknown.

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

Each pool leg's swap fee, as its own StakeRemoved (sell leg) / StakeAdded (buy leg) event states it, sell before buy, zero fees kept: one entry on a buy or sell row, two on a swap (the sell leg on netuid, the buy leg on counterpart_netuid, also when they are equal), [] on every other side. A swap fee is not a transaction fee (that is the extrinsic's tx_fee). An entry's amount_rao can be null while the trade derivation is still sizing that row (filled in place, never 0): such a page is never cached as settled.

4 fields in swap_fees (each item)
legenum

The pool leg: sell (alpha into the pool, its StakeRemoved) or buy (TAO into the pool, its StakeAdded). A swap row has both, sell first.

One of: sell, buy
assetstring

What the fee was taken in, naming amount_rao's denomination: alpha of netuid (a sell leg) or tao (a buy leg). New values may be added; show an unknown value as is (or generically).

netuidinteger · unit id · can be null

The leg's subnet: the pool the leg traded against (on a swap, netuid for the sell leg and counterpart_netuid for the buy leg). Null when the source does not name it.

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

The fee in the leg's asset's base unit (decimal string): rao when asset is tao, alpha rao of netuid when asset is alpha (a mixed-denomination field: x-unit keeps rao as the 1e9 scale and asset names the denomination; never add an alpha amount to TAO). 0 when the chain charged none. Null = not yet sized (the row's fee isn't available yet; filled in place, never 0): a page holding one is not final.

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

tao_rao in USD at the latest TAO/USD price at or before the block's time (within the price's resolution plus 10 minutes), 2 decimals; an amount: event rows are valued when they happened, not at meta.at. Null when tao_rao is null or no such price exists.

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

The coldkey whose stake moved (the beneficiary), SS58. Null for a trade without a staking event (the signer is then the account).

Format: SS58 address
hotkeystring · can be null

The hotkey the stake sits on, SS58. Null when the trade has none.

Format: SS58 address
signerstring · can be null

The extrinsic's signer, SS58: who signed, not necessarily whose stake moved (a proxy, an EVM caller). Null for a block hook or an EVM-originated call without a substrate signer.

Format: SS58 address
extrinsic_hashstring · can be null

Hash of the extrinsic, 0x + 64 lower-case hex. Null for a block hook.

Format: 32-byte hex: 0x and 64 hex digits
generationinteger · unit id · can be null · beta

Opaque life id (the life's registration identifier), NOT a block height; use life_start_height for the first block. The life of the row's subnet (netuid) at its block (the life the candles key on). Null when no life is recorded, and on an older data version's answer.

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.

counterpart_generationinteger · unit id · can be null · beta

On a swap, the life of the destination subnet (counterpart_netuid) at the row's block; null on every other side, and on an older data version's answer.

eventsarray of objects · can be null

Only with include=events: the newest child_limit events carrying this subnet, exactly the first page of GET /events?netuid={netuid} (meta.sections.events).

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

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

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

The block it was emitted in.

indexinteger · unit id

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

timestring (date-time) · can be null

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

Format: date and time, ISO 8601 in UTC
phasestring

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

extrinsic_idstring · unit id · can be null

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

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

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

call_idstring · unit id · can be null

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

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

The event's kind.

2 fields in event
palletstring

The pallet, as in the runtime metadata (e.g. SubtensorModule).

namestring

The event, as in the runtime metadata (PascalCase, e.g. StakeAdded).

argsobject · can be null

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

error_palletstring · can be null

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

error_namestring · can be null

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

hyperparam_changesarray of objects · can be null

Only with include=hyperparam_changes: the subnet's newest child_limit hyperparameter changes, exactly the first page of GET /subnets/{netuid}/hyperparam-changes (meta.sections.hyperparam_changes).

16 fields in hyperparam_changes (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
revenuearray of objects · can be null

Only with include=revenue: the owner's revenue per day over the last 30 days, exactly GET /subnets/{netuid}/revenue (meta.sections.revenue). Null when unavailable (the reason is in meta.sections.revenue.unavailable_reason).

10 fields in revenue (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
net_emissionarray of objects · can be null

Only with include=net_emission: the 1 / 7 / 30-day windows, exactly GET /subnets/{netuid}/net-emission (meta.sections.net_emission). Null when unavailable.

14 fields in net_emission (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.

emission_sharearray of objects · can be null

Only with include=emission_share: the subnet's emission share per day over the last 90 days, exactly GET /subnets/{netuid}/emission-share (meta.sections.emission_share). Null when unavailable.

8 fields in emission_share (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)

The same summed over every subnet that day, rao.

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

The subnet's rank by tao_in_rao that day (1 = the largest; ties share).

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
candles_1darray of objects · can be null

Only with include=candles_1d: the last 90 daily candles of the current generation, oldest first, exactly GET /subnets/{netuid}/candles?interval=1d&limit=90 (meta.sections.candles_1d). Null when unavailable.

32 fields in candles_1d (each item)
open_atstring (date-time)

Start of the bucket, RFC 3339 UTC.

Format: date and time, ISO 8601 in UTC
openstring · unit tao_per_alpha · 9 decimals

Price (TAO per alpha) entering the bucket: the previous block's close, same subnet life; 9 decimals.

Format: decimal number with 9 places, as a string
highstring · unit tao_per_alpha · 9 decimals

Highest price (TAO per alpha) in the bucket, 9 decimals.

Format: decimal number with 9 places, as a string
lowstring · unit tao_per_alpha · 9 decimals

Lowest price (TAO per alpha) in the bucket, 9 decimals.

Format: decimal number with 9 places, as a string
closestring · unit tao_per_alpha · 9 decimals

Price (TAO per alpha) after the bucket's last block, as the runtime reports it; 9 decimals.

Format: decimal number with 9 places, as a string
open_price_usdstring · unit usd_per_alpha · 6 decimals · can be null

open as a USD price (USD per alpha, not an amount), 6 decimals: the previous bar's close (the series' first bar: its alpha open at the TAO/USD rate just before it), where each point is the alpha price in TAO x TAO/USD at that point's close (per-minute products at every interval, hourly before 2024-04-11 for TAO's composite; meta.fiat_method states it), so a TAO/USD move inside a bar is in its range and open_price_usd equals the previous bar's close_price_usd. On an older data version's answer the four are the TAO prices x one TAO/USD rate at the bucket's close. Null when no TAO/USD price exists.

Format: decimal number, as a string
high_price_usdstring · unit usd_per_alpha · 6 decimals · can be null

high as a USD price (USD per alpha, not an amount), 6 decimals: the highest point of the bar, the open included, where each point is the alpha price in TAO x TAO/USD at that point's close (per-minute products at every interval, hourly before 2024-04-11 for TAO's composite; meta.fiat_method states it), so a TAO/USD move inside a bar is in its range and open_price_usd equals the previous bar's close_price_usd. On an older data version's answer the four are the TAO prices x one TAO/USD rate at the bucket's close. Null when no TAO/USD price exists.

Format: decimal number, as a string
low_price_usdstring · unit usd_per_alpha · 6 decimals · can be null

low as a USD price (USD per alpha, not an amount), 6 decimals: the lowest point of the bar, the open included, where each point is the alpha price in TAO x TAO/USD at that point's close (per-minute products at every interval, hourly before 2024-04-11 for TAO's composite; meta.fiat_method states it), so a TAO/USD move inside a bar is in its range and open_price_usd equals the previous bar's close_price_usd. On an older data version's answer the four are the TAO prices x one TAO/USD rate at the bucket's close. Null when no TAO/USD price exists.

Format: decimal number, as a string
close_price_usdstring · unit usd_per_alpha · 6 decimals · can be null

close as a USD price (USD per alpha, not an amount), 6 decimals: the bar's last point, where each point is the alpha price in TAO x TAO/USD at that point's close (per-minute products at every interval, hourly before 2024-04-11 for TAO's composite; meta.fiat_method states it), so a TAO/USD move inside a bar is in its range and open_price_usd equals the previous bar's close_price_usd. On an older data version's answer the four are the TAO prices x one TAO/USD rate at the bucket's close. Null when no TAO/USD price exists.

Format: decimal number, as a string
open_price_fiatstring · unit ccy_per_alpha · 6 decimals · can be null

open in meta.fiat_currency per alpha (a price), 6 decimals: the same per-point rule as open_price_usd with each point also x its UTC day's ECB rate of that currency (on an older data version's answer, _price_usd x the ECB rate at the bucket's close). Null without the currency parameter, and when either rate is missing.

Format: decimal number, as a string
high_price_fiatstring · unit ccy_per_alpha · 6 decimals · can be null

high in meta.fiat_currency per alpha (a price), 6 decimals: the same per-point rule as high_price_usd with each point also x its UTC day's ECB rate of that currency (on an older data version's answer, _price_usd x the ECB rate at the bucket's close). Null without the currency parameter, and when either rate is missing.

Format: decimal number, as a string
low_price_fiatstring · unit ccy_per_alpha · 6 decimals · can be null

low in meta.fiat_currency per alpha (a price), 6 decimals: the same per-point rule as low_price_usd with each point also x its UTC day's ECB rate of that currency (on an older data version's answer, _price_usd x the ECB rate at the bucket's close). Null without the currency parameter, and when either rate is missing.

Format: decimal number, as a string
close_price_fiatstring · unit ccy_per_alpha · 6 decimals · can be null

close in meta.fiat_currency per alpha (a price), 6 decimals: the same per-point rule as close_price_usd with each point also x its UTC day's ECB rate of that currency (on an older data version's answer, _price_usd x the ECB rate at the bucket's close). Null without the currency parameter, and when either rate is missing.

Format: decimal number, as a string
volume_usdstring · unit usd · 2 decimals · can be null

volume_tao_rao in USD, 2 decimals; an amount: each point's TAO volume x that point's TAO/USD, summed (on an older data version's answer, the whole volume x TAO/USD at the bucket's close). Null when no TAO/USD price exists.

Format: decimal number, as a string
volume_tao_raostring · unit rao (÷1e9)

TAO into plus out of the pool by extrinsic swap steps (each counted once), in rao.

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

TAO into the pool by buys (TAO in, alpha out), in rao.

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

TAO out of the pool by sells (alpha in, TAO out), in rao.

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

Alpha into plus out of the pool, in alpha rao.

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

Number of swap steps in the bucket.

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

TAO reserve of the pool at the bucket's close, in rao.

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

Alpha reserve (alpha in) of the pool at the bucket's close, in alpha rao.

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

First block of the bucket with a pool record; null on a carried bucket (is_carried). On a partial bucket it can be below meta.coverage.from_height (the bucket began before coverage).

last_heightinteger · unit block · can be null

Last block of the bucket processed so far; null on a carried bucket (is_carried).

is_carriedboolean · optional · beta

True when the bar has no price of its own: open, high, low and close are the close before it (the previous bar's; for a page's first bar, the last price before it) and the volumes are 0 (carried_reason says why). The series is continuous, so a quiet bucket is a carried bar, never a gap.

carried_reasonstring · can be null · beta

Why the bar is carried: no_trades (no swap and no pool change in the bucket), no_source_data (no price was recorded for the bucket), coarser_source (a minute bar inside an hour whose prices are known only hourly: before 2024-04-11 12:00 UTC the TAO/USD series is hourly). Null exactly when is_carried is false. New values may be added; treat unknown values as unavailable.

carriedboolean · deprecated

True when the bucket has no swap and no pool change recorded: open, high, low and close are the previous bucket's close (for the first bucket of a page, the pool's price and reserves just before it), trades and the volumes are 0, first_height / last_height are null. The series is continuous, so a quiet hour is a carried bucket, never a gap, even on a pool that never swapped. Deprecated: use is_carried; sunset 2027-02-15.

Deprecated since 2026-10-17, removed after 2027-02-15. Use is_carried instead.
closedboolean

False while the bucket is still forming (its end is after meta.at).

partialboolean

True when the bucket began before meta.coverage.from_height (its volume, trade count and open miss the blocks before coverage) or before the life's first block (meta.life_start_height: the life's first bucket covers only its own blocks), so it is not a whole bucket. False otherwise.

finalboolean · optional · beta

True when the bar can no longer change: it ends at or before meta.final_through (its open_at plus the interval). A final bar is safe to cache for good. False while the bar is forming or may still be corrected, and on every bar while meta.final_through is null.

fx_sourcestring · can be null · beta

Who published the reference rate of the bar's last price point, the one that priced the fiat close (for example ecb). Null without currency, on a bar without fiat prices, and while meta.fx_unavailable_reason is set. New values may be added; show an unknown value as is (or generically).

fx_day_firststring (date) · can be null · beta

The earliest UTC rate day among the price points inside this bar (each point is priced at the latest reference rate published on or before its day). The fiat open is not one of them: it is the previous point's close at that point's rate, so its rate day is the previous bar's fx_day_last (for the page's first bar, the rate in force before the page, listed in meta.fx_days). Equal to fx_day_last when every point inside the bar has the same rate day. Null without currency, on a bar without fiat prices, and while meta.fx_unavailable_reason is set.

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

The latest UTC rate day among the price points inside this bar (each point is priced at the latest reference rate published on or before its day); the fiat close's rate day. Null without currency, on a bar without fiat prices, and while meta.fx_unavailable_reason is set.

Format: date, YYYY-MM-DD

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.