Documentation / API reference / Burn
Get Burned Alpha Total
Reference
Last reviewed 2026-09-18
Returns cumulative Alpha token burn totals by subnet, with the block and timestamp of each record. Filter by netuid or sort by the available ordering options.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | ||
page | query | integer (int32) | ||
limit | query | integer (int32) | ||
order | query | string | One of netuid_asc, netuid_desc, amount_asc, amount_desc. |
Responses
200 — Dtao burned alpha total retrieved successfully
| Field | Type | Required |
|---|---|---|
data | array | Yes |
data[].amount | string | Yes |
data[].block_number | integer (int32) | Yes |
data[].netuid | integer (int32) | Yes |
data[].timestamp | string (date-time) | Yes |
pagination | object | Yes |
pagination.current_page | integer (int32) | Yes |
pagination.next_page | integer (int32), nullable | |
pagination.per_page | integer (int32) | Yes |
pagination.prev_page | integer (int32), nullable | |
pagination.total_items | integer (int32) | Yes |
pagination.total_pages | integer (int32) | Yes |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Dtao burned alpha total not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.