Skip to content
TAO$188.31
BTC0.002929
MCap$2.21B
Vol$86.07M

API reference / Subnets

Every subnet's daily close price, market cap and emission share, per life

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

Per subnet life.

Full description

Per subnet life (netuid, generation: a re-registered slot is a new life) and closed UTC day, oldest first, every value at the day's last block: the runtime price (TAO and USD at the day's TAO/USD close), alpha outstanding and the spot market cap (TAO and USD), the subnet's share of the day's whole TAO emission (emission_share_ratio: injected + excess) and of the injected TAO alone (tao_in_share_ratio, the /subnets emission_share_1d_ratio measure), its TAO emission, the pool's TAO and the day's volume. A partial day covers only part of the day (the history's floor or the life's start): at the floor its volume is null (never a part-day sum). Pool liquidity at the close (from 2025-02-13; null with liquidity_unavailable_reason not_ready while the data isn't available yet): the two reserves, the last swap and its age in blocks and the day's swaps, each over all swaps and over the users' swaps alone (no protocol step), as information only (they change no value), and this API's fv_level (the valuation standard's depth level, null exactly with liquidity_unavailable_reason; L3 under 1 alpha in reserve, an empty pool included). netuids narrows it (default every subnet). The oldest day served is meta.range.available_from_day (a from_day before it is raised to it, meta.range.from_day_raised); it moves earlier as older history is added. Moves when the next day closes: cached as slow. Every point says day_status (closed | open) and as_of_height. The open day is opt-in: with to_day = today (UTC) each life's last point may be today so far (day_status open, meta.open_day set: today's pool candle, the emission members null), served once the newest closed day is yesterday; it is never in a default answer, and an answer carrying it is cached as tip. Day window: from_day / to_day (inclusive UTC days), or days back from to_day (not both days and from_day); no ceiling: a range longer than meta.page.limit_days pages by cursor (meta.page.next_cursor), oldest days first, and meta.range states the whole request (from_day raised to the first available day says so). An explicit to_day is never answered with an earlier day: one not available yet is a 503 NOT_READY. While paged day windows are not available yet, from_day, to_day and cursor are a 503 SOURCE_NOT_READY (a days-only request is unchanged). Errors are application/problem+json: INVALID_NETUID, INVALID_DAYS, INVALID_DAY, INVALID_RANGE, INVALID_CURSOR, UNKNOWN_PARAMETER, NOT_READY (503), NOT_FINAL (503), SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503). meta.final_through_day is the key to cache closed days by: the rows through it never change again (but by an announced rerun); later rows may (null on an older data version's answer).

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

Query parameters

netuidsquery· string

Only these subnets. A comma list (or the parameter repeated) of subnets, each 0..65535, as many as needed; duplicates are ignored. Anything else is a 400 INVALID_NETUID.

daysquery· integer · default 90 · at least 1

How many closed UTC days end at to_day (default 90, ending at the newest closed day; fewer where the daily candles starts later: meta.from_day says where). No ceiling: a range longer than one page pages by cursor (while paged day windows are not available yet, more than 365 is a 400 INVALID_DAYS). Not with from_day (both: a 400 INVALID_RANGE). Outside 1..1,000,000 is a 400 INVALID_DAYS.

to_dayquery· string (date)

A UTC day, YYYY-MM-DD. Today: adds today's open row (day_status open) after the closed days (an opt-in; without it the answer is closed days only). A closed day: the window ends there, final or refused, never an earlier day (a day not available yet is a 503 NOT_READY, one after meta.final_through_day a 503 NOT_FINAL; while paged day windows are not available yet, a 503 SOURCE_NOT_READY). After today: a 400 INVALID_RANGE; anything else a 400 INVALID_DAY.

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

The first UTC day, YYYY-MM-DD, inclusive (raised to the first available day: meta.range.from_day_raised). Not with days (both: a 400 INVALID_RANGE); after to_day: a 400 INVALID_RANGE; not a date: a 400 INVALID_DAY.

Format: date, YYYY-MM-DD
cursorquery· string · up to 200 characters

meta.page.next_cursor of the previous page: the next days of a range longer than one page, sent back unchanged with the same other parameters (a changed or altered one is a 400 INVALID_CURSOR). While paged day windows are not available yet: 503 SOURCE_NOT_READY.

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 item per subnet life with a day in the window, by netuid then generation.

netuidinteger · unit id

The subnet slot.

generationinteger · unit id · can be null

Opaque life id (the life's registration identifier), NOT a block height; use life_start_height for the first block. Which life of the slot this is.

is_current_lifeboolean · can be null

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

life_start_heightinteger · unit block · can be null

The life's first block.

is_current_generationboolean

Whether this is the slot's live subnet now.

from_daystring (date)

The life's first point in the window.

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

The life's last point in the window.

Format: date, YYYY-MM-DD
pointsarray of objects

One per day the life has a pool row, oldest first.

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

The UTC day.

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

The day's last block: every value is the one in force at the day's end (for a life that ended that day, at its last change).

price_taostring · unit tao_per_alpha · 9 decimals

The runtime price at that block, TAO per alpha, 9 decimals (root: 1).

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

price_tao x the day's TAO/USD close, USD per alpha, 6 decimals. Null without that close.

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

SubnetAlphaOut (alpha outstanding) at that block, alpha rao. Null when not read.

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

alpha_out_rao x the price at that block, floored, rao of TAO: the spot market cap. Null exactly with alpha_out_rao.

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

The market cap at the day's TAO/USD close, USD, 6 decimals. Null when the cap or the close is.

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

The subnet's share of the day's whole TAO emission: (SubnetTaoInEmission + SubnetExcessTao) over every subnet's, summed over the day's blocks, 0..1, 8 decimals. Null until the emission dataset covers the day.

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

The injected TAO's share alone (the /subnets emission_share_1d_ratio measure), 0..1, 8 decimals. Null with no emission row that day.

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

The subnet's TAO emission that day, rao: injected + excess (the excess swapped for protocol alpha). Null when the excess is not covered that day.

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

The pool's TAO at that block, rao.

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

TAO traded through the life's pool that day (buys + sells), rao. Null on a partial day cut by the history's floor (a part-day sum is not the day's volume); a life's own first day keeps its volume.

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

The point covers only part of the day: the history's floor, the life's start or its end falls inside it (on a re-registration day each life's point counts only its own blocks).

day_statusstring

closed: a finished UTC day. open: today so far, served only with to_day = today (the opt-in; never by default), as each life's last point: today's pool candle (the latest close as the price, the volume so far, alpha outstanding at the candle's last block), its emission members (emission_share_ratio, tao_in_share_ratio, tao_emission_rao, computed for closed days only) null. A closed day is final at or before meta.final_through_day; a closed day after it is still being finalised (the nightly close, typically minutes after 00:00 UTC, or an announced repair). The open row is today so far (it moves with every reading). On an answer read before the source served this member every row is closed. New values may be added; show an unknown value as is (or generically).

as_of_heightinteger · unit block · can be null

The block the point reads: the day's last block (closed), the candle's last block so far (open). Null on an answer read before the source served it.

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

SubtensorModule.SubnetEmaTaoFlow at the day's last block (I64F64, rendered with 12 places), in TAO rao per block, signed: the EMA of the per-block net user TAO flow that set emission shares from runtime v334 to v419. Served from 2025-11-04 (its first write, block 6,811,691). Frozen since v421 (block 8,466,531, 2026-06-23), when emission shares moved to the price EMA: later days repeat the frozen value (ema_tao_flow_height 8,466,530), which is not that day's flow. Null on a day whose value isn't available yet, on an open point, for a life without a value (not emitting yet, or a re-registration day's ended life), and on an older data version's answer.

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

The block that EMA was last advanced at: the day's last block while it moved, 8,466,530 since the freeze. Null with ema_tao_flow_tao_rao.

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

The pool's TAO reserve (SubnetTAO) at the day's close, rao. Null on a day whose figures aren't available yet (liquidity_unavailable_reason not_ready; they are being prepared back to 2025-02-13), on the open point and on an older data version's answer.

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

The pool's alpha reserve (SubnetAlphaIn) at the day's close, alpha rao: what fv_level is computed from. Null on a day whose figures aren't available yet (liquidity_unavailable_reason not_ready; they are being prepared back to 2025-02-13), on the open point and on an older data version's answer.

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

The block of this life's last pool swap at or before the day's close (protocol swaps included). Null when the life has never traded (a new life starts again; trades_in_day is then a number). Null on a day whose figures aren't available yet (liquidity_unavailable_reason not_ready; they are being prepared back to 2025-02-13), on the open point and on an older data version's answer. Information only (for display such as "last traded N blocks ago"): it does not affect any value.

last_trade_age_blocksinteger · unit blocks · can be null

height - last_trade_height (checked): how many blocks before the close the last swap was. Null exactly with last_trade_height. Information only (for display such as "last traded N blocks ago"): it does not affect any value.

trades_in_dayinteger · unit count · can be null

This life's pool swaps during the day (protocol swaps included); 0 = none. Null on a day whose figures aren't available yet (liquidity_unavailable_reason not_ready; they are being prepared back to 2025-02-13), on the open point and on an older data version's answer. Information only (for display such as "last traded N blocks ago"): it does not affect any value.

last_user_trade_heightinteger · unit block · can be null

The block of this life's last USER pool swap at or before the day's close: a buy, sell or swap, never a protocol step (registration, root claim, basket claim or basket swap). At or before last_trade_height (checked). Null when no user has swapped in the life yet. Null on a day whose figures aren't available yet (liquidity_unavailable_reason not_ready; they are being prepared back to 2025-02-13), on the open point and on an older data version's answer. Information only (for display such as "last traded N blocks ago"): it does not affect any value.

last_user_trade_age_blocksinteger · unit blocks · can be null

height - last_user_trade_height (checked): how many blocks before the close the last user swap was. Null exactly with last_user_trade_height. Information only (for display such as "last traded N blocks ago"): it does not affect any value.

trades_user_in_dayinteger · unit count · can be null

This life's USER pool swaps during the day (buy / sell / swap; no protocol step), at most trades_in_day (checked); 0 = none. Null on a day whose figures aren't available yet (liquidity_unavailable_reason not_ready; they are being prepared back to 2025-02-13), on the open point and on an older data version's answer. Information only (for display such as "last traded N blocks ago"): it does not affect any value.

liquidity_unavailable_reasonstring · can be null

Why fv_level is null, else null: not_ready (the day's close does not carry the liquidity figures yet: they become available day by day, see meta.liquidity_from_day; or a re-registration day's ended life, whose last block is not the close), open_day (the open point: the figures are written at the close), no_pool (root: no AMM). New values may be added; treat unknown values as unavailable.

fv_levelstring · can be null

Computed by this API from the two reserves at the close: the pool's fair-value level (valuation standard 2026-09-23, standard_version 1): L1 when a reference sale of 10 alpha moves the price by less than 1 % and the alpha reserve holds at least 1,000 alpha; L2 when it holds at least 1 alpha; else L3 (less than 1 alpha, an alpha reserve of 0 or a TAO reserve of 0 included). A pool property. Null exactly with liquidity_unavailable_reason. New values may be added; show an unknown value as is (or generically).

Response headers

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

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

Cache-Control

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

CDN-Cache-Control

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

X-BTAI-Stale

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

X-BTAI-Stale-As-Of

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

RateLimit-Policy

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

RateLimit

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

X-RateLimit-Limit

The tier's request quota of the current window.

X-RateLimit-Remaining

Requests left in the current window.

X-RateLimit-Reset

When the current window resets, Unix seconds.

Status codes

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

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

Error codes

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

From the API's published specification, version 1.165.0.