Latest coldkey alpha shares per hotkey/subnet

Endpoint

GET /api/dtao/coldkey_alpha_shares/latest/v1

Description

Returns the latest alpha-share holdings for coldkey stakes, broken out per (hotkey, subnet) position. Alpha shares behave like LP tokens: shares is a stable claim on the delegation pool while alpha shows the equivalent alpha amount at the current pool state, so a coldkey’s redeemable balance can grow even if its share count doesn’t.

Filter by coldkey, hotkey, or netuid to scope the result, and use alpha_min/alpha_max to focus on positions of a given size. For historical share balances see /api/dtao/coldkey_alpha_shares/history/v1.

Parameters

Name	In	Type	Required	Description
alpha_min	query	string		Minimum equivalent alpha amount (in rao).
alpha_max	query	string		Maximum equivalent alpha amount (in rao).
coldkey	query	string		Filter by stakeholder coldkey (SS58 or hex).
hotkey	query	string		Filter by delegated 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 coldkey 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",
          "coldkey",
          "hotkey",
          "shares",
          "alpha"
        ],
        "properties": {
          "alpha": {
            "type": "string"
          },
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "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"
              }
            }
          },
          "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 coldkey 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.