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

API reference / Subnets

Every live subnet: price, changes, market cap, volume

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

The subnet directory and ticker at one block.

Full description

The subnet directory and ticker at one block: one row per registered subnet (root included), by netuid, with 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. netuids=1,64 (or netuid=1,64) narrows it to those subnets (one snapshot). Unpaged by default (one row per live subnet, ~130); sort / order sort it server-side and limit / cursor page it (the cursor pins the first page's block; meta.page only with limit), the ticker's sort_by / limit. Exact inside meta.coverage. 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. Errors are application/problem+json: INVALID_NETUID, INVALID_SORT, INVALID_ORDER, INVALID_LIMIT, INVALID_CURSOR, INCLUDE_AT_HEAD_ONLY, 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), SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503).

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.

netuidquery· string

Only these subnets: a comma list of netuids (0..65535; OR), rows still by netuid ascending, a slot without a live subnet simply absent. Omitted: every live subnet. Anything else is a 400 INVALID_NETUID. The same list as netuids, the name every other route uses for a list of subnets.

netuidsquery· string

Only these subnets: a comma list of netuids (0..65535; OR), exactly as netuid takes it (netuids is the name every route uses for a list of subnets; netuid stays accepted). Not with netuid (a 400 INVALID_NETUID). Anything else is a 400 INVALID_NETUID.

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
sortquery· enum · one of netuid, price_tao, price_change_1h_ratio, price_change_24h_ratio, price_change_7d_ratio, price_change_30d_ratio, change_24h_usd_ratio, volume_24h_tao_rao, volume_7d_tao_rao, volume_30d_tao_rao, net_flow_24h_tao_rao, net_flow_7d_tao_rao, net_flow_30d_tao_rao, trades_24h, market_cap_spot_tao_rao, market_cap_ex_burned_spot_tao_rao, market_cap_circulating_spot_tao_rao, pool_tao_rao, tvl_tao_rao, emission_share_1d_ratio, total_return_30d_ratio, life_start_height

Sort the rows by one member (computed by this API on the one snapshot; nothing changes at the data source): netuid, price_tao, price_change_1h_ratio, price_change_24h_ratio, price_change_7d_ratio, price_change_30d_ratio, change_24h_usd_ratio, volume_24h_tao_rao, volume_7d_tao_rao, volume_30d_tao_rao, net_flow_24h_tao_rao, net_flow_7d_tao_rao, net_flow_30d_tao_rao, trades_24h, market_cap_spot_tao_rao, market_cap_ex_burned_spot_tao_rao, market_cap_circulating_spot_tao_rao, pool_tao_rao, tvl_tao_rao, emission_share_1d_ratio, total_return_30d_ratio, life_start_height. A null sorts last in both directions; ties by netuid ascending. Omitted: by netuid (the route's order before). Anything else is a 400 INVALID_SORT.

orderquery· enum · one of asc, desc

asc or desc. Default: asc for netuid (or no sort), desc for every other key (largest first). Anything else is a 400 INVALID_ORDER.

limitquery· integer · 1 to 1000

Page size, 1..1000: serve the first limit sorted rows and meta.page (next_cursor for the rest). Omitted: every row, unpaged (no meta.page). Outside the range: a 400 INVALID_LIMIT.

cursorquery· string · up to 200 characters

meta.page.next_cursor of the previous page, sent back with the same other parameters (limit too). It pins the first page's block, so every page reads one snapshot (as an at height: such a page is cached as settled once final). A cursor for other parameters, altered, or without limit is a 400 INVALID_CURSOR; with include=registration (head only) a 400 INCLUDE_AT_HEAD_ONLY.

Response

data is a list of objects 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.

One row per registered subnet at meta.at, root included, by netuid ascending.

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).

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.