List alpha-burn events

Endpoint

GET /api/dtao/burned_alpha/v1

Description

Returns individual alpha-burn events on dTao subnets. Each row records the block, subnet, hotkey and coldkey involved, the burned amount, and whether the burn came from an incentive mechanism (incentive) or an explicit burn call (call).

Use the burn_type, netuid, hotkey, coldkey, and extrinsic_id filters to isolate specific burns; scope the window with the block or timestamp ranges. For subnet-level totals see /api/dtao/burned_alpha/total/v1. Background on burns: Burning.

Parameters

Name	In	Type	Required	Description
netuid	query	integer		Subnet id.
hotkey	query	string		Filter by hotkey involved in the burn (SS58 or hex).
coldkey	query	string		Filter by coldkey involved in the burn (SS58 or hex).
extrinsic_id	query	string		Filter by the extrinsic that produced the burn.
burn_type	query	string		Burn source: incentive or call.
block_start	query	integer		Start of block range (inclusive).
block_end	query	integer		End of block range (inclusive).
timestamp_start	query	integer		Start of Unix timestamp range in seconds (inclusive).
timestamp_end	query	integer		End of Unix timestamp range in seconds (inclusive).
amount_min	query	string		Minimum burned amount (in rao).
amount_max	query	string		Maximum burned amount (in rao).
page	query	integer		1-based page number.
limit	query	integer		Page size (max 200).
order	query	—		Sort order, e.g. block_number_desc, amount_desc.

Responses

200 — Dtao burned alpha retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "block_number",
          "timestamp",
          "netuid",
          "hotkey",
          "coldkey",
          "amount",
          "burn_type"
        ],
        "properties": {
          "amount": {
            "type": "string"
          },
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "burn_type": {
            "type": "string"
          },
          "coldkey": {
            "type": "object",
            "required": [
              "ss58",
              "hex"
            ],
            "properties": {
              "hex": {
                "type": "string",
                "description": "The hex format of the hot key"
              },
              "ss58": {
                "type": "string",
                "description": "The SS58 format of the hot key"
              }
            }
          },
          "extrinsic_id": {
            "type": "string",
            "nullable": true
          },
          "hotkey": {
            "type": "object",
            "required": [
              "ss58",
              "hex"
            ],
            "properties": {
              "hex": {
                "type": "string",
                "description": "The hex format of the hot key"
              },
              "ss58": {
                "type": "string",
                "description": "The SS58 format of the hot key"
              }
            }
          },
          "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 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.