Aggregated delegation volume

Endpoint

GET /api/dtao/delegation_volume/v1

Description

Returns network-wide staking volume aggregated into time buckets. Each bucket splits volume between root delegation (root_volume, TAO staked to the root subnet) and alpha delegation (alpha_volume_as_tao, alpha volume converted to TAO at trade time), and reports the alpha share of the total in proportion_alpha.

Use this to chart the network-wide shift from root staking to dTao alpha delegation over time. For per-subnet net TAO flow see /api/dtao/tao_flow/v1; for individual swap events see /api/dtao/trade/v1.

Parameters

Name	In	Type	Description
`frequency`	query	`—`	Bucket size: `15min`, `60min`, or `1day`. Defaults to `60min`.
`page`	query	`integer`	1-based page number.
`limit`	query	`integer`	Page size (max 200).

Responses

`200` — Delegation volume retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "block_number",
          "timestamp",
          "alpha_volume_as_tao",
          "root_volume",
          "proportion_alpha"
        ],
        "properties": {
          "alpha_volume_as_tao": {
            "type": "string"
          },
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "proportion_alpha": {
            "type": "string"
          },
          "root_volume": {
            "type": "string"
          },
          "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` — Delegation volume 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.