Cumulative burned alpha per subnet

Endpoint

GET /api/dtao/burned_alpha/total/v1

Description

Returns the cumulative amount of alpha burned per dTao subnet as of the latest snapshot. Each row includes the subnet id, the running total burned, and the block and timestamp the total was recorded at.

Use this to compare burn totals across subnets or track a single subnet’s cumulative supply reduction. For the underlying per-event stream see /api/dtao/burned_alpha/v1.

Parameters

Name	In	Type	Description
`netuid`	query	`integer`	Filter to a single subnet. Omit to return totals for all subnets.
`page`	query	`integer`	1-based page number.
`limit`	query	`integer`	Page size (max 200).
`order`	query	`—`	Sort order, e.g. `amount_desc`, `netuid_asc`.

Responses

`200` — Dtao burned alpha total retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "block_number",
          "timestamp",
          "netuid",
          "amount"
        ],
        "properties": {
          "amount": {
            "type": "string"
          },
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "netuid": {
            "type": "integer",
            "format": "int32"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    },
    "pagination": {
      "type": "object",
      "required": [
        "current_page",
        "per_page",
        "total_items",
        "total_pages"
      ],
      "properties": {
        "current_page": {
          "type": "integer",
          "format": "int32"
        },
        "next_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "per_page": {
          "type": "integer",
          "format": "int32"
        },
        "prev_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "total_items": {
          "type": "integer",
          "format": "int32"
        },
        "total_pages": {
          "type": "integer",
          "format": "int32"
        }
      }
    }
  }
}

`400` — Bad request

`404` — Dtao burned alpha total not found

`500` — Internal server error

Try it

Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).

Authentication

All Taostats API requests require an Authorization header containing your API key. See Getting Started.