Skip to content
TAO$188.32
BTC0.002928
MCap$2.22B
Vol$86.25M

API reference / Subnets

A subnet's alpha emitted, burned, recycled and net over windows of days

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

For each window of UTC days ending at the last available day.

Full description

For each window of UTC days ending at the last available day (meta.last_day), shortest first: the alpha emitted to participants (emitted_participants_alpha_rao, every emission component summed, and split by component), the alpha injected into the pool (injected_alpha_rao), ALL alpha issued (emitted_alpha_rao = both), the alpha burned (SubtensorModule.AlphaBurned's increases) and recycled (AlphaRecycled's), and net = emitted - burned - recycled. Every leg is served; none is hidden in a total. A window is complete when each of its days is available and the supply counters cover it; burned / recycled are null (together) where the counters do not, the injection and the totals where the protocol emission record does not, and net whenever a leg is null. Days are computed from meta.history_from_day, so a long window can be incomplete for now. daily=true serves one 1-day window per UTC day instead, over the last days available days, oldest first (meta.daily says which): the per-day chart. Day window: from_day (or cursor) serves the daily rows from from_day to to_day (no ceiling: pages of meta.page.limit_days by cursor; meta.range, the page's meta.from_day / meta.to_day); to_day alone ends the windows (or with daily=true the days) at that day instead of the last available one, never at an earlier day (one not available yet: 503 NOT_READY). While paged day windows are not available yet, those parameters are a 503 SOURCE_NOT_READY. One life: a netuid is a slot and a re-registered subnet is a new life; the series covers the subnet's CURRENT life only, from its first whole UTC day (meta.generation, meta.life_start_height, meta.life_first_day; a life with no whole day yet answers no rows). While per-life series are not available yet, the series is not limited to one life and those members are null. A window reaching before the life's first whole day starts there (floored_at_life true, not complete); a to_day before the first day available is a 400 INVALID_RANGE. Moves when the next day is available, so cached as slow. Errors are application/problem+json: INVALID_WINDOWS, INVALID_DAYS, INVALID_DAY, INVALID_RANGE, INVALID_CURSOR, SUBNET_NOT_FOUND (404), UNKNOWN_PARAMETER, NOT_READY (503), SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503).

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

Path parameters

netuidpath, required· integer · 0 to 65535

Subnet slot (0 = root).

Query parameters

windowsquery· string

Day counts, a comma list of 1..8 distinct values, each 1..365 (default 1,7,30). Anything else is a 400 INVALID_WINDOWS; with daily=true a 400 INVALID_WINDOWS too (a day is its own window).

dailyquery· boolean · default false

true: one row per available UTC day (a 1-day window each) over the last days days, oldest first, instead of the windows. Default false.

daysquery· integer

With daily=true: how many of the last available days, 1..366 (default 30; fewer where the history starts later), ending at to_day when given. Without daily=true, or out of range, a 400 INVALID_DAYS; with from_day a 400 INVALID_RANGE.

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. Serves the daily rows (not with windows: 400 INVALID_WINDOWS).

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

The UTC day the windows (or the daily rows) end at, YYYY-MM-DD (default: the last available day). Never answered with an earlier day: one not available yet is a 503 NOT_READY; today is a 503 NOT_READY, a later 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 row per window asked for, shortest first; with daily=true one row per UTC day, oldest first.

window_daysinteger · unit days

The window's length in UTC days (one of windows).

from_daystring (date) · can be null

The window's first UTC day. Null (with to_day) when the window holds no day of the subnet's current life (a subnet registered today): floored_at_life true, days_available 0, every figure null.

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

The window's last UTC day (meta.last_day). Null with from_day when the window holds no day of the subnet's current life.

Format: date, YYYY-MM-DD
days_availableinteger · unit count · optional

How many of the window's days are available.

days_builtinteger · unit count · deprecated

How many of the window's days are available. Deprecated: use days_available; sunset 2027-02-15.

Deprecated since 2026-10-17, removed after 2027-02-15. Use days_available instead.
completeboolean

True when every day of the window is available and the supply counters cover it. A false window's figures are a lower bound (missing days), or null where the counters do not cover it.

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

ALL alpha issued on the subnet in the window: emitted_participants_alpha_rao + injected_alpha_rao, alpha rao. Null with injected_alpha_rao (a total that leaves the injection out is never served; an older data version's answer has no injection, so it is null there).

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

Alpha the window's epochs drained to participants (server + validator + root + the owner cut), alpha rao. The credited components of emitted_by_component_alpha_rao sum to at most it: incentive withheld from an owner / immune miner is burned or recycled, never credited. Null below the epoch-drain floor (unknown, never 0); the totals computed from it are null too and complete is false.

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

Alpha injected into the subnet's pool (SubtensorModule.SubnetAlphaInEmission, per block) in the window, alpha rao. Null while the window's protocol flows aren't available yet, and on an older data version's answer.

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

emitted_participants_alpha_rao split by component, alpha rao: miner_incentive, nominator_dividend, validator_take, owner_cut, root_take, root_claimable_queued, basket_flush_credit, ... Clients must accept components not documented yet.

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

SubtensorModule.AlphaBurned's increases in the window, alpha rao. Null when the supply counters do not cover the window (never a partial sum).

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

SubtensorModule.AlphaRecycled's increases in the window, alpha rao. Null as burned_alpha_rao.

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

emitted_alpha_rao (all issuance) - burned_alpha_rao - recycled_alpha_rao, alpha rao (may be negative). Null when any of those is null.

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

True when the window starts at the subnet's current life's first whole day (meta.life_first_day) instead of window_days back: a younger life serves its days so far (complete false; burned / recycled are the life's). Null on an older data version's answer, whose windows could reach into the previous life.

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.