Every subnet's daily close price, market cap and emission share, per life
https://api.bittensor.ai/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_daysays where). No ceiling: a range longer than one page pages bycursor(while paged day windows are not available yet, more than 365 is a 400INVALID_DAYS). Not withfrom_day(both: a 400INVALID_RANGE). Outside 1..1,000,000 is a 400INVALID_DAYS.- to_dayquery· string (date)
A UTC day,
YYYY-MM-DD. Today: adds today's open row (day_statusopen) 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 503NOT_READY, one aftermeta.final_through_daya 503NOT_FINAL; while paged day windows are not available yet, a 503SOURCE_NOT_READY). After today: a 400INVALID_RANGE; anything else a 400INVALID_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 withdays(both: a 400INVALID_RANGE); afterto_day: a 400INVALID_RANGE; not a date: a 400INVALID_DAY.- Format: date, YYYY-MM-DD
- cursorquery· string · up to 200 characters
meta.page.next_cursorof 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 400INVALID_CURSOR). While paged day windows are not available yet: 503SOURCE_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_heightfor the first block. Which life of the slot this is.- 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 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_taox 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_raox the price at that block, floored, rao of TAO: the spot market cap. Null exactly withalpha_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
- 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
partialday 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 withto_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 beforemeta.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 isclosed. 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_height8,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_reasonnot_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_levelis computed from. Null on a day whose figures aren't available yet (liquidity_unavailable_reasonnot_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_dayis then a number). Null on a day whose figures aren't available yet (liquidity_unavailable_reasonnot_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 withlast_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_reasonnot_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_reasonnot_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 withlast_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_reasonnot_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.- 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):
L1when a reference sale of 10 alpha moves the price by less than 1 % and the alpha reserve holds at least 1,000 alpha;L2when it holds at least 1 alpha; elseL3(less than 1 alpha, an alpha reserve of 0 or a TAO reserve of 0 included). A pool property. Null exactly withliquidity_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), slowpublic, max-age=300, stale-while-revalidate=600(state that moves in minutes or days) or tippublic, max-age=6, stale-while-revalidate=12(follows the chain head); the label routes are cached until the next nightly copy (public, max-age=<seconds>, stale-while-revalidate=60). Neverimmutable.no-storeon an earlier answer served because the data source failed (X-BTAI-Stale).- CDN-Cache-Control
The same class for shared caches (RFC 9213; browsers ignore it): settled 24 h, slow 300 s, tip 6 s, each with
stale-while-revalidateandstale-if-error;no-storewithX-BTAI-Stale.- X-BTAI-Stale
Present only when the data source failed to answer (it timed out or was unavailable) and an earlier answer to the same request is served instead of a 503 (stale if error, RFC 5861). Then
if-error, withX-BTAI-Stale-As-Of,Age(its seconds since then) andWarning: 110 - "Response is Stale", andCache-Control: no-store: the answer is never kept as fresh, and a later request reads again. Prices and quotes are never served this way.- X-BTAI-Stale-As-Of
With
X-BTAI-Stale: when the earlier answer served was produced, an RFC 3339 UTC time (2026-10-21T12:00:00Z).- RateLimit-Policy
The tier's request quota of the current window (IETF draft), e.g.
"tier";q=600.- RateLimit
Requests left in the current window and the seconds until it resets (IETF draft), e.g.
"tier";r=597;t=42.- X-RateLimit-Limit
The tier's request quota of the current window.
- X-RateLimit-Remaining
Requests left in the current window.
- X-RateLimit-Reset
When the current window resets, Unix seconds.
Status codes
200 · 304 · 400 · 401 · 402 · 403 · 404 · 429 · 500 · 502 · 503
304 Not Modified: the If-None-Match validator still matches; no body.
Error codes
The codes this endpoint can return. Each links to what it means and what to do.
- AMBIGUOUS_CREDENTIALS
- BAD_GATEWAY
- BILLING_UNAVAILABLE
- BUDGET_EXCEEDED
- CONCURRENCY_LIMIT
- INSUFFICIENT_PERMISSIONS
- INTERNAL_ERROR
- INVALID_CURSOR
- INVALID_DAY
- INVALID_DAYS
- INVALID_NETUID
- INVALID_RANGE
- NOT_FINAL
- NOT_READY
- PAYMENT_REQUIRED
- PLAN_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.