Latest hotkey alpha shares per subnet

Endpoint

GET /api/dtao/hotkey_alpha_shares/latest/v1

Description

Returns the latest alpha-share totals aggregated at the (hotkey, subnet) level. Each row shows how much a hotkey has staked to it on a given subnet: the total share count and the equivalent alpha amount at the current pool state.

Use this to rank validators by stake weight without walking every coldkey. For per-coldkey breakdowns see /api/dtao/coldkey_alpha_shares/latest/v1; for history see /api/dtao/hotkey_alpha_shares/history/v1.

Parameters

Name	In	Type	Description
`alpha_min`	query	`string`	Minimum equivalent alpha amount (in rao).
`alpha_max`	query	`string`	Maximum equivalent alpha amount (in rao).
`hotkey`	query	`string`	Filter by hotkey (SS58 or hex).
`netuid`	query	`integer`	Subnet id.
`page`	query	`integer`	1-based page number.
`limit`	query	`integer`	Page size (max 200).
`order`	query	`—`	Sort order, e.g. `alpha_desc`, `shares_desc`.

Responses

`200` — Dtao hotkey alpha shares retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "block_number",
          "timestamp",
          "netuid",
          "hotkey",
          "shares",
          "alpha"
        ],
        "properties": {
          "alpha": {
            "type": "string"
          },
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "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"
          },
          "shares": {
            "$ref": "#/components/schemas/BigDecimal"
          },
          "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 hotkey alpha shares 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.