Documentation / New API reference / Subnets
Get Subnets Burns Daily
Reference
Last reviewed 2026-10-07
The chain's cumulative burn counter turned into one bar per UTC day for one subnet.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | Yes | Subnet ID. Required — the series is per subnet. |
days | query | integer (int32) | How many whole UTC days to return, ending today. Default 30, max 36,500. |
Responses
200 — Alpha burned per UTC day for one subnet
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].amount | string, nullable | Yes | Alpha burned during this UTC day (RAO, u64 as a decimal string). null means "not knowable", never "nothing was burned". It is null in exactly four cases, all of them real: the previous day has no row, so there is nothing to difference against; the counter fell, which is the chain clearing it at the end of a subnet generation; the day contains the spec-446 rebase; or the subnet was registered between the two days' sampled blocks, which restarts the counter. A zero here is a genuine zero. |
data[].block_number | integer (int32) | Yes | The block the cumulative figure was read at — the last block of this day that the snapshot table holds. Reported so a disputed number can be traced to one row rather than argued about. |
data[].date | string | Yes | The UTC day this bucket covers, YYYY-MM-DD. |
data[].netuid | integer (int32) | Yes | Subnet ID. |
data[].timestamp | string | Yes | ISO 8601 timestamp of that block, millisecond precision. |
data[].total_alpha_burned | string | Yes | The chain's cumulative counter at that block (RAO, u64 as a decimal string). This is the same column /v1/subnets/burns/total serves, subnet_pool_v1.total_alpha_burned, copied from that day's last row into subnet_pool_by_utc_day_v1: by the indexer, in the same batch as the history row, and for days before the indexer wrote the table, by backfill_subnet_pool_by_utc_day. The indexer's two inserts run concurrently and neither is guaranteed to become visible first, so the current day's value can differ from the total, in either direction, for that moment. |
400 — Invalid query parameter
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
500 — Internal server error
| Field | Type | Required | Description |
|---|---|---|---|
message | string | Yes | Plain-english message describing the failure from the caller's perspective. |
status_code | integer (int32) | Yes | HTTP status code (mirrored in the response status line for convenience). |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.