A subnet's alpha emitted, burned, recycled and net over windows of days
https://api.bittensor.ai/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 400INVALID_WINDOWS; withdaily=truea 400INVALID_WINDOWStoo (a day is its own window).- dailyquery· boolean · default false
true: one row per available UTC day (a 1-day window each) over the lastdaysdays, oldest first, instead of the windows. Defaultfalse.- daysquery· integer
With
daily=true: how many of the last available days, 1..366 (default 30; fewer where the history starts later), ending atto_daywhen given. Withoutdaily=true, or out of range, a 400INVALID_DAYS; withfrom_daya 400INVALID_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 withdays(both: a 400INVALID_RANGE); afterto_day: a 400INVALID_RANGE; not a date: a 400INVALID_DAY. Serves the daily rows (not withwindows: 400INVALID_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 503NOT_READY; today is a 503NOT_READY, a later 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 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_lifetrue,days_available0, every figure null.- Format: date, YYYY-MM-DD
- to_daystring (date) · can be null
The window's last UTC day (
meta.last_day). Null withfrom_daywhen 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_availableinstead. - 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 withinjected_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_raosum 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 andcompleteis 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_raosplit 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 ofwindow_daysback: a younger life serves its days so far (completefalse; 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), 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_PARAMETER
- INVALID_RANGE
- INVALID_WINDOWS
- NOT_READY
- PAYMENT_REQUIRED
- PLAN_REQUIRED
- RATE_LIMITED
- REPEATED_PARAMETER
- SERVICE_UNAVAILABLE
- SOURCE_BUSY
- SOURCE_NOT_READY
- SOURCE_TIMEOUT
- SUBNET_NOT_FOUND
- UNAUTHORIZED
- UNKNOWN_PARAMETER
- VALIDATION_ERROR
From the API's published specification, version 1.165.0.