Net TAO flow per subnet

Endpoint

GET /api/dtao/tao_flow/v1

Description

Returns the net TAO flow into or out of each subnet pool over the queried block or timestamp window. Positive tao_flow means net TAO buying pressure (users staking TAO into the subnet, taking alpha out of the pool); negative means net TAO leaving (users unstaking to TAO).

Use this to spot capital rotation between subnets, identify subnets receiving inflows, and size trades against subnet liquidity. For individual swap events see /api/dtao/trade/v1; for aggregated volume broken down by direction and time bucket see /api/dtao/delegation_volume/v1.

Parameters

Name	In	Type	Description
`netuid`	query	`integer`	Subnet id. Omit to return flow for every subnet.
`block_start`	query	`integer`	Start of block range (inclusive). Pair with `block_end` to bound the flow window by block.
`block_end`	query	`integer`	End of block range (inclusive).
`timestamp_start`	query	`integer`	Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive).
`timestamp_end`	query	`integer`	End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive).

Responses

`200` — Tao flow retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "netuid",
          "tao_flow"
        ],
        "properties": {
          "netuid": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "tao_flow": {
            "type": "number",
            "format": "double"
          }
        }
      }
    },
    "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` — Tao flow 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.