Every live subnet: price, changes, market cap, volume
https://api.bittensor.ai/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), a0xblock 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 400INVALID_AT: it has no timestamp. A time the indexed head has not reached yet (in the future, or not indexed yet) is a 503NOT_FINALwithRetry-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(fillssparkline_7d_tao, 7 d of hourly closes, andsparkline_7d_complete),state(fillsstate: epoch, pending emission, lifetime volume, registration figures and the owner's lock),hyperparams(fillshyperparams: the effective hyperparameters, with the registrations over 24 h / 7 d / 30 d in the current generation, proof of work among them, up tometa.registrations_to_height),neurons(fillsneurons: the metagraph counts),holders(fillsholders: alpha holders by coldkey, top-10 share and Nakamoto coefficient at the latest closed UTC day at or beforemeta.at) andyield(fillsyield: the stakers' alpha APY, each pool's value-per-share growth net of the validator's take, alpha-weighted, at the same day),emission(fillsemission: the alpha the subnet's emission credited by component over 1 / 7 / 30 closed UTC days) andbuyback(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, andowner_buyback_burn_*, its add_stake_burn buybacks, TAO staked and alpha burned; the pool buys' earlier namesowner_buyback_30d_tao_rao..owner_buyback_lifetime_from_heightare served alongside with the same values for one version, deprecated; reads 30 days of trades for every subnet's owner), andmeta(fillsmeta: 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'sgeneration; no extra data-source call). OnGET /subnets/{netuid}only,valuation(fillsvaluation: 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, 400INCLUDE_AT_HEAD_ONLYwithat; on the list a 400INVALID_INCLUDE), andprofile(fillsprofile: 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'sgenerationlikemeta(every life keeps its own page: withatinside an ended life, that life's); no extra data-source call, +0; on the list a 400INVALID_INCLUDE;pageis its deprecated spelling, and either fills bothprofileand the deprecatedpage), andhalving(fillshalving: the subnet's ALPHA halving schedule, computed by this API from the row'salpha_issuance_rao, the halvings so far, the emission now and after the next halving and the issuance thresholds; withstatechecked against the chain's last emission; no extra data-source call, +0; on the list a 400INVALID_INCLUDE). Members combine freely (state,meta,page,valuation), eachregistration(fillsregistration: 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.registrationsays where it was read, or whyregistrationis null:not_ready(not deployed on this data source yet) orsource_unavailable, the rest of the answer served either way; on the directory head only, 400INCLUDE_AT_HEAD_ONLYwithatorto_day; on one subnet read at the answer's block).state,hyperparamsandneuronsare read at the head only (null off it). Omitted, those members are null. Anything else is a 400INVALID_INCLUDE. Withmeta, an answer pinned byatis cached as slow (5 min), not settled: the content is today's. Metering: the route's weight (2) plusbuyback+1 (andregistration+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 asnetuids, 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
netuidtakes it (netuidsis the name every route uses for a list of subnets;netuidstays accepted). Not withnetuid(a 400INVALID_NETUID). Anything else is a 400INVALID_NETUID.- to_dayquery· string (date)
A closed UTC day,
YYYY-MM-DD(the day view): the read at that day's last block, withholders,yieldandemissionthat day's;meta.to_dayechoes it. Not withat(both: a 400INVALID_AT). Only a final day is served: today or later is a 503NOT_FINALbefore 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 503NOT_READY; never an earlier day. A day before the chain's first block (2023-03-20) is a 400AT_OUT_OF_COVERAGE. A served day is cached as settled. Anything else is a 400INVALID_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 bynetuidascending. Omitted: bynetuid(the route's order before). Anything else is a 400INVALID_SORT.- orderquery· enum · one of asc, desc
ascordesc. Default:ascfornetuid(or nosort),descfor every other key (largest first). Anything else is a 400INVALID_ORDER.- limitquery· integer · 1 to 1000
Page size, 1..1000: serve the first
limitsorted rows andmeta.page(next_cursorfor the rest). Omitted: every row, unpaged (nometa.page). Outside the range: a 400INVALID_LIMIT.- cursorquery· string · up to 200 characters
meta.page.next_cursorof the previous page, sent back with the same other parameters (limittoo). It pins the first page's block, so every page reads one snapshot (as anatheight: such a page is cached as settled once final). A cursor for other parameters, altered, or withoutlimitis a 400INVALID_CURSOR; withinclude=registration(head only) a 400INCLUDE_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_heightfor the first block. The life of the subnet occupyingnetuid: 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
generationis the slot's current life (true) or an ended one, re-registered since (false). Null exactly whengenerationis null, or transiently when this API cannot read the lives. Root'sgeneration0 is current.- 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
netuidslot: 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 togeneration, 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_reasonsays why.- 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_taoxmeta.tao_usd: USD per alpha (a price), 6 decimals. Null withoutmeta.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 beforemeta.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 beforemeta.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 beforemeta.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 beforemeta.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 ofprice_change_1h_ratio(price_tao/ it - 1, before that ratio's 6-place rounding), so a client can recompute the change exactly;1on 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 ofprice_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 ofprice_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 ofprice_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_alphaleaves it unchanged) and the protocol's alpha: seeeffective_alpha_out_raoandcirculating_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 withalpha_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
atbefore 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 (atbelow the pool dataset's head; seemeta.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 (
atbelow the pool dataset's head; seemeta.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.atandmeta.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 behindmeta.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.atandmeta.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 behindmeta.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.atandmeta.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 behindmeta.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.atandmeta.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 behindmeta.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.atandmeta.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 behindmeta.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.atandmeta.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 behindmeta.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_raoxprice_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_raoin USD atmeta.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) xprice_tao), in rao of TAO: the spot market cap without the alpha burned since v411. Null whenalpha_burned_raois null, except on root (where it equalsmarket_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 whenalpha_burned_raois 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 inalpha_out_raobut held by no account, in alpha rao. Null where the chain has no entry. Null off the head (atbelow the pool dataset's head; seemeta.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_basisnames what was subtracted), in alpha rao. Root:alpha_out_rao. Null whenalpha_burned_raois 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_raoexcludes:excludes_burned_and_protocol,excludes_burned(no protocol alpha entry) oralpha_out(root: nothing excluded). Null withcirculating_alpha_rao. Clients must accept values not documented yet.- market_cap_circulating_spot_tao_raostring · unit rao (÷1e9) · can be null
floor(
circulating_alpha_raoxprice_tao), in rao of TAO: the spot market cap of the alpha accounts hold. Null withcirculating_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_raoin USD atmeta.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 beforemeta.at, oldest first. One value per hour frommeta.tao_usd_sparkline_7d_from(aligned index by index withmeta.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.) Seesparkline_7d_complete.- Format: decimal number with 9 places, as a string
- sparkline_7d_completeboolean · can be null
Only with
include=sparkline, else null: false whensparkline_7d_taostarts 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 (anatbelow 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 atmeta.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.atheight -last_step_height: blocks since the subnet's last epoch (so the two always add up tometa.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).
- 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 equalcoldkey(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_raoand 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'scirculating_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 offmeta.at. The subnet'scost_modelis 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_ratiois 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_productbefore v290,concentrated_liquidityv290-v422,balancerfrom 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_u16is 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.atheight <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_rank1 (subnetInfo_getSubnetToPrune), false on every other.
- leaseobject · can be null
The subnet's lease (null on an older data version's answer):
lease_idand 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
- 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 (withleader_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.- 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'salpha_issuance_raois the same measure atmeta.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_itemsnames 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 matchingpow_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 atmeta.registrations_to_height. Null unless the decoded events span the window and reach within 100 blocks ofmeta.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 matchingpow_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 atmeta.registrations_to_height. Null unless the decoded events span the window and reach within 100 blocks ofmeta.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 matchingpow_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 atmeta.registrations_to_height. Null unless the decoded events span the window and reach within 100 blocks ofmeta.at(never a partial count).- pow_registrations_24hinteger · unit count · can be null
Successful proof-of-work
registercalls on this subnet in the 24 hours beforemeta.at(at any call depth: inside a batch or proxy too), current generation only; 0 when none (they are rare). Null with the matchingregistrations_*.- pow_registrations_7dinteger · unit count · can be null
Successful proof-of-work
registercalls on this subnet in the 7 days beforemeta.at(at any call depth: inside a batch or proxy too), current generation only; 0 when none (they are rare). Null with the matchingregistrations_*.- pow_registrations_30dinteger · unit count · can be null
Successful proof-of-work
registercalls on this subnet in the 30 days beforemeta.at(at any call depth: inside a batch or proxy too), current generation only; 0 when none (they are rare). Null with the matchingregistrations_*.
- 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_millix 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=neuronscannot 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_minersmay 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 leastactive_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 beforemeta.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 atday_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 whenalpha_raois 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_raoand 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
holdersonday- 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_raoonday- 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
holdersonday- 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_raoonday- 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 atday): 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 beforemeta.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 atday; 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; seeSubnetYield). 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_ratioandapy_7d_ratioare 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 atday; 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; seeSubnetYield). 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 atday; 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; seeSubnetYield). 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_ratioover the 7 days ending atday, 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_ratioover the 30 days ending atday, 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_ratioover the 30 days ending atday(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
daywhose pools stand behindapy_1d_ratio(a value per share on both day ends). 0 when none does (thenapy_1d_ratiois 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_dayand 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 atday(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_ratioover the 90 days ending atday, oldest first, fromsparkline_90d_from_day: one entry per available day (a day without data is absent, not null), null where that day'sapy_1d_ratiois, 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_ratioas it stood 7 days beforeday(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 ofapy_30d_ratio), anapyRatioFigure over the 30 days today- 7 (checked): a value only when all 30 days of that window are available, elseinsufficient_historywithdays_oksaying how far it got. Null on an answer read before the source served it.days_okcounts the current life's days only (insufficient_historywhen 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_reasonis set, and served only whendays_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 withnot_readyornot_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 beforemeta.at's day. Null withfrom_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 withfrom_day.- days_expectedinteger · unit count
The nominal window in days: 7 or 30.
- 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 beforemeta.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
dayby its emission steps (exact per step, from the emission credits), in alpha rao: the sum ofby_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_raosplit 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) andbasket_flush_credit. An open map: only components credited that day appear, and clients must accept components not documented yet.
- price_sourcestring
Where
price_taocomes from:pool_spot, the pool's spot price atmeta.at(the runtime's current alpha price from the reserves; the only value served today), orlast_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_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_rankon 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 beforemeta.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 asprice_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_ratioof the latest available yield day at or beforemeta.at(read whether or notinclude=yieldis 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) orprice_return_30d_ratiois.- 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_ratioit 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 rootalpha_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 (anatbelow 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 beforemeta.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 exceedsowner_pool_buys_lifetime_tao_rao(checked). Not the burn buyback (owner_buyback_burn_30d_tao_rao). The new name of the deprecatedowner_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 aboveowner_pool_buys_lifetime_alpha_rao(checked). Null withowner_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_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 sinceowner_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 (seeowner_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 beforemeta.at(SubtensorModule.AddStakeBurn events whose extrinsic it signed; the alpha bought is burned), in rao; 0 when none. A part ofowner_buyback_burn_lifetime_tao_rao(checked). The gross pool buys areowner_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 aboveowner_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 isowner_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_raoinstead. - 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 isowner_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_raoinstead. - 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 isowner_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_raoinstead. - 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 isowner_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_raoinstead. - 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 isowner_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_heightinstead. - 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 thancost_model(computed by this API atstate.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_ratioin the 7th decimal even at the same block). 8 decimals; root 0; null asround_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 asround_trip_cost_ratio.- 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_taoxmeta.tao_usd/ (price_24h_ago_taoxmeta.tao_usd_24h_ago) - 1, a signed ratio with 6 decimals (0.05 = +5 %): the subnet's move and TAO's together, whereprice_change_24h_ratiois 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, asprice_24h_ago_tao), and on an older data version's answer (nometa.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_raoin USD atmeta.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_raoin USD atmeta.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) fromstate.pool's raw inputs atstate_height, with the chain's swap reimplemented exactly (Balancer and stable curves). Always an object; its figures are null with anunavailable_reason(no_statewithoutinclude=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 atstate_height(fees and slippage), a fraction of one, 8 decimals (half up). 0 on astablesubnet. Null withunavailable_reason.- Format: decimal number, as a string
- entry_cost_ratiostring · unit ratio · 8 decimals · can be null
1 -
alpha_out_raox 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 atstate_height, exact. 8 decimals; 0 on astablesubnet. Null withunavailable_reason.- Format: decimal number, as a string
- exit_cost_ratiostring · unit ratio · 8 decimals · can be null
1 -
tao_back_rao/ (alpha_out_raox spot): the unstake's loss against spot (the fee and the sell's slippage). 8 decimals; 0 on astablesubnet. (1 - entry) x (1 - exit) = 1 - round trip. Null withunavailable_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 withoutstate.- mechanismstring · can be null
The curve modelled (
state.pool.swap_mechanism). Null withoutstate. 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'sround_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).
- 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 ANDgeneration: 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_heightfor the first block. The life this content was matched to: the row'sgeneration.- life_start_heightinteger · unit block · can be null
The first block of the life
generationnames (GET /subnets/generations'start_height): use it, nevergeneration, for heights, ages and dates. Null exactly whengenerationis null (root without a life, no subnet), or transiently when this API cannot read the lives. Root'sgeneration0 starts at 0.- is_current_lifeboolean · can be null
Whether
generationis the slot's current life (true) or an ended one, re-registered since (false). Null exactly whengenerationis null, or transiently when this API cannot read the lives. Root'sgeneration0 is current.- 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
namecame from. Null whennameis 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_reasonsays why.- 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.
- 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 oneGET /api/v2/subnets/{netuid}/reposerves: 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 withrepo_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
taglinecame 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) orderived(taken from the subnet's description). Null whentaglineis 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_formatismarkdown. Null when there is none or it is a placeholder. The owner's own long write-up, when published, isowner_provided.descriptionon the subnet detail.- description_formatenum · optional
markdownonly when the description carries unmistakable markdown (a heading, code fence, link, bold text, a pipe-delimited grid, or two or more list lines); otherwiseplain(the default), to be rendered as text.- One of:
plain,markdown - description_sourceenum · can be null
Where
descriptioncame 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) orderived(taken from the subnet's description). Null whendescriptionis 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
summarycame from:derived(an opaque identifier: taken fromdescription) whensummaryis set; null otherwise.- One of:
owner,admin,chain,derived
- linksobject · beta
The contact and social fields merged with their provenance: an admin override first, else the on-chain identity, else bittensor.ai's own record. Each member null when unknown.
11 fields in links
- websitestring · can be null
The subnet's website URL. Null when none is known.
- website_sourcestring · can be null
Where the value came from:
admin(a bittensor.ai override),chain(the owner's on-chain identity) orgithub(bittensor.ai's own subnet record). Null exactly when the value is. New values may be added; show an unknown value as is (or generically).- discordstring · can be null
Its Discord link or handle. Null when none is known.
- discord_sourcestring · can be null
Where the value came from:
admin(a bittensor.ai override),chain(the owner's on-chain identity) orgithub(bittensor.ai's own subnet record). Null exactly when the value is. New values may be added; show an unknown value as is (or generically).- contact_emailstring · can be null
Its contact (email or other). Null when none is known.
- contact_email_sourcestring · can be null
Where the value came from:
admin(a bittensor.ai override),chain(the owner's on-chain identity) orgithub(bittensor.ai's own subnet record). Null exactly when the value is. New values may be added; show an unknown value as is (or generically).- owner_namestring · can be null
The owner's display name (no on-chain source). Null when none is known.
- owner_name_sourcestring · can be null
Where the value came from:
admin(a bittensor.ai override),chain(the owner's on-chain identity) orgithub(bittensor.ai's own subnet record). Null exactly when the value is. New values may be added; show an unknown value as is (or generically).- twitterstring · can be null
Its X / Twitter handle (no on-chain source). Null when none.
- twitter_sourcestring · can be null
Where the value came from:
admin(a bittensor.ai override),chain(the owner's on-chain identity) orgithub(bittensor.ai's own subnet record). Null exactly when the value is. New values may be added; show an unknown value as is (or generically).- logo_url_sourcestring · can be null
Where
logo_urlcame from:chain(our copy of the on-chain identity's logo) whenever it is served. Where the value came from:admin(a bittensor.ai override),chain(the owner's on-chain identity) orgithub(bittensor.ai's own subnet record). Null exactly when the value is. New values may be added; show an unknown value as is (or generically).
- profileobject · can be null
Only with
include=profile(or its deprecated spellinginclude=page) onGET /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 ANDgenerationlikemeta. Every life of the slot keeps its own page and logo, so a row of an ended life (atinside 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_heightfor the first block. The life this page was matched to: the row'sgeneration.- life_start_heightinteger · unit block · can be null
The first block of the life
generationnames (GET /subnets/generations'start_height): use it, nevergeneration, for heights, ages and dates. Null exactly whengenerationis null (root without a life, no subnet), or transiently when this API cannot read the lives. Root'sgeneration0 starts at 0.- is_current_lifeboolean · can be null
Whether
generationis the slot's current life (true) or an ended one, re-registered since (false). Null exactly whengenerationis null, or transiently when this API cannot read the lives. Root'sgeneration0 is current.- logo_urlstring · can be null
The logo the owner uploaded. Null when none.
- taglinestring · can be null
The owner's tagline, raw. Null when none.
- descriptionstring · can be null
The owner's long description, raw. Null when none.
- featured_linksarray of objects
Links the owner features, in their order.
2 fields in featured_links (each item)
- titlestring
The link's label, as the owner wrote it.
- urlstring
The link's URL, as the owner wrote it.
- team_membersarray of objects
The team, in the owner's order.
4 fields in team_members (each item)
- namestring
The member's name.
- rolestring · can be null
Their role, as the owner wrote it. Null when none.
- avatar_urlstring · can be null
Their avatar image URL. Null when none.
- github_urlstring · can be null
The repository URL the owner gave. Null when none.
- documentation_urlstring · can be null
The documentation URL the owner gave. Null when none.
- min_stake_to_validate_tao_raostring · unit rao (÷1e9) · can be null
The owner's stated minimum stake to validate, in rao (owner-provided, not a chain value).
- Format: whole number, as a string · on chain: u64
- hardware_notesstring · can be null
The owner's hardware notes, raw. Null when none.
- updated_atstring (date-time) · can be null
When the owner last saved the page. Null when only the cached logo is served.
- Format: date and time, ISO 8601 in UTC
- chain_logoobject · can be null
The cached on-chain logo with suggested colours. Null when none matches the live identity.
4 fields in chain_logo
- urlstring
The cached logo (our CDN), served only while the live identity points at it.
- suggested_primarystring · can be null
A primary colour extracted from the logo,
#rrggbb. Null when none was extracted.- suggested_secondarystring · can be null
A secondary colour extracted from the logo,
#rrggbb. Null when none.- suggested_accentstring · can be null
An accent colour extracted from the logo,
#rrggbb. Null when none.
- pageobject · can be null · deprecated
The same record as
profile, under its old name: served with it wheneverinclude=profileorinclude=pageis asked (absent otherwise). Deprecated: use profile; sunset 2027-02-15.- Deprecated since 2026-10-16, removed after 2027-02-15. Use
profileinstead. 17 fields in page
- generationinteger · unit id · can be null
Opaque life id (the life's registration identifier), NOT a block height; use
life_start_heightfor the first block. The life this page was matched to: the row'sgeneration.- life_start_heightinteger · unit block · can be null
The first block of the life
generationnames (GET /subnets/generations'start_height): use it, nevergeneration, for heights, ages and dates. Null exactly whengenerationis null (root without a life, no subnet), or transiently when this API cannot read the lives. Root'sgeneration0 starts at 0.- is_current_lifeboolean · can be null
Whether
generationis the slot's current life (true) or an ended one, re-registered since (false). Null exactly whengenerationis null, or transiently when this API cannot read the lives. Root'sgeneration0 is current.- logo_urlstring · can be null
The logo the owner uploaded. Null when none.
- taglinestring · can be null
The owner's tagline, raw. Null when none.
- descriptionstring · can be null
The owner's long description, raw. Null when none.
- featured_linksarray of objects
Links the owner features, in their order.
2 fields in featured_links (each item)
- titlestring
The link's label, as the owner wrote it.
- urlstring
The link's URL, as the owner wrote it.
- team_membersarray of objects
The team, in the owner's order.
4 fields in team_members (each item)
- namestring
The member's name.
- rolestring · can be null
Their role, as the owner wrote it. Null when none.
- avatar_urlstring · can be null
Their avatar image URL. Null when none.
- github_urlstring · can be null
The repository URL the owner gave. Null when none.
- documentation_urlstring · can be null
The documentation URL the owner gave. Null when none.
- min_stake_to_validate_tao_raostring · unit rao (÷1e9) · can be null
The owner's stated minimum stake to validate, in rao (owner-provided, not a chain value).
- Format: whole number, as a string · on chain: u64
- hardware_notesstring · can be null
The owner's hardware notes, raw. Null when none.
- updated_atstring (date-time) · can be null
When the owner last saved the page. Null when only the cached logo is served.
- Format: date and time, ISO 8601 in UTC
- chain_logoobject · can be null
The cached on-chain logo with suggested colours. Null when none matches the live identity.
4 fields in chain_logo
- urlstring
The cached logo (our CDN), served only while the live identity points at it.
- suggested_primarystring · can be null
A primary colour extracted from the logo,
#rrggbb. Null when none was extracted.- suggested_secondarystring · can be null
A secondary colour extracted from the logo,
#rrggbb. Null when none.- suggested_accentstring · can be null
An accent colour extracted from the logo,
#rrggbb. Null when none.
- valuationobject · can be null
Only with
include=valuationonGET /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 withunavailable_reason.- Format: decimal number, as a string
- interpretationenum · can be null
The multiple's band:
below_trendunder 1,at_trendfrom 1 to under 2.4,overheatedfrom 2.4 (Trace Mayer's bands). Null withunavailable_reason.- One of:
below_trend,at_trend,overheated
- 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_daytoprice_day, the fit's x at whichfair_value_price_usdis 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 atprice_day, USD per alpha of this subnet, 6 decimals. Null withunavailable_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 withunavailable_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
- halvingobject · can be null
Only with
include=halvingonGET /subnets/{netuid}(absent otherwise): the subnet's ALPHA halving schedule, computed by this API from this row'salpha_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=statechecked againststate.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'salpha_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).
- 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 atmeta.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), slowpublic, max-age=300, stale-while-revalidate=600(state that moves in minutes or days) or tippublic, max-age=6, stale-while-revalidate=12(follows the chain head); the label routes are cached until the next nightly copy (public, max-age=<seconds>, stale-while-revalidate=60). Neverimmutable.no-storeon an earlier answer served because the data source failed (X-BTAI-Stale).- CDN-Cache-Control
The same class for shared caches (RFC 9213; browsers ignore it): settled 24 h, slow 300 s, tip 6 s, each with
stale-while-revalidateandstale-if-error;no-storewithX-BTAI-Stale.- X-BTAI-Stale
Present only when the data source failed to answer (it timed out or was unavailable) and an earlier answer to the same request is served instead of a 503 (stale if error, RFC 5861). Then
if-error, withX-BTAI-Stale-As-Of,Age(its seconds since then) andWarning: 110 - "Response is Stale", andCache-Control: no-store: the answer is never kept as fresh, and a later request reads again. Prices and quotes are never served this way.- X-BTAI-Stale-As-Of
With
X-BTAI-Stale: when the earlier answer served was produced, an RFC 3339 UTC time (2026-10-21T12:00:00Z).- RateLimit-Policy
The tier's request quota of the current window (IETF draft), e.g.
"tier";q=600.- RateLimit
Requests left in the current window and the seconds until it resets (IETF draft), e.g.
"tier";r=597;t=42.- X-RateLimit-Limit
The tier's request quota of the current window.
- X-RateLimit-Remaining
Requests left in the current window.
- X-RateLimit-Reset
When the current window resets, Unix seconds.
Status codes
200 · 304 · 400 · 401 · 402 · 403 · 404 · 429 · 500 · 502 · 503
304 Not Modified: the If-None-Match validator still matches; no body.
Error codes
The codes this endpoint can return. Each links to what it means and what to do.
- AMBIGUOUS_CREDENTIALS
- AT_OUT_OF_COVERAGE
- BAD_GATEWAY
- BILLING_UNAVAILABLE
- BLOCK_NOT_FOUND
- BUDGET_EXCEEDED
- CONCURRENCY_LIMIT
- INCLUDE_AT_HEAD_ONLY
- INSUFFICIENT_PERMISSIONS
- INTERNAL_ERROR
- INVALID_AT
- INVALID_CURSOR
- INVALID_DAY
- INVALID_INCLUDE
- INVALID_LIMIT
- INVALID_NETUID
- INVALID_ORDER
- INVALID_SORT
- NOT_FINAL
- NOT_READY
- PAYMENT_REQUIRED
- RATE_LIMITED
- REPEATED_PARAMETER
- SERVICE_UNAVAILABLE
- SOURCE_BUSY
- SOURCE_NOT_READY
- SOURCE_TIMEOUT
- UNAUTHORIZED
- UNKNOWN_PARAMETER
- VALIDATION_ERROR
From the API's published specification, version 1.165.0.