Skip to content
Taostats Docs

Validator Root Baskets

Endpoint

Section titled “Endpoint”
GET /api/dtao/validator/basket/latest/v1

Try it

Section titled “Try it”
Get a free API key →
curl

Description

Section titled “Description”

Root Reborn reinvests root dividends into a per-validator fund (“beta basket”) held under a protocol escrow account. Stakers hold shares in that fund and redeem via claim_root.

Parameters

Section titled “Parameters”
NameInTypeRequiredDescription
hotkeyquerystringSS58 or hex format
pagequeryinteger
limitqueryinteger
orderquery—

Responses

Section titled “Responses”

200 — Validator baskets retrieved successfully

Section titled “200 — Validator baskets retrieved successfully”

Media: application/json

Schema
{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "hotkey",
          "block_number",
          "timestamp",
          "nav_tao",
          "spot_nav_tao",
          "shares",
          "deposited_tao",
          "redeemed_tao",
          "weights",
          "holdings"
        ],
        "properties": {
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "day": {
            "type": "string",
            "format": "date",
            "description": "Present on the history endpoint only.",
            "nullable": true
          },
          "deposited_tao": {
            "type": "string"
          },
          "holdings": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "One subnet position inside a validator's beta basket.",
              "required": [
                "netuid",
                "alpha",
                "spot_tao",
                "realizable_tao"
              ],
              "properties": {
                "alpha": {
                  "type": "string"
                },
                "netuid": {
                  "type": "integer",
                  "format": "int32"
                },
                "realizable_tao": {
                  "type": "string",
                  "description": "Slippage-aware redemption value \u2014 what NAV is built from."
                },
                "spot_tao": {
                  "type": "string",
                  "description": "Spot-marked value (`price * alpha`) \u2014 display only."
                }
              }
            }
          },
          "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"
              }
            }
          },
          "nav_per_share": {
            "type": "string",
            "description": "`nav_tao / shares`. Null when the fund has no shares outstanding.",
            "nullable": true
          },
          "nav_tao": {
            "type": "string",
            "description": "Realizable (slippage-aware) NAV in rao \u2014 the fund's redemption value."
          },
          "performance": {
            "type": "string",
            "description": "`(nav_tao + redeemed_tao) / deposited_tao`. Null when nothing deposited.",
            "nullable": true
          },
          "rate": {
            "type": "string",
            "description": "Shares accrued per unit of root stake.",
            "nullable": true
          },
          "redeemed_tao": {
            "type": "string"
          },
          "shares": {
            "type": "string",
            "description": "Outstanding fund shares."
          },
          "spot_nav_tao": {
            "type": "string",
            "description": "Spot-marked NAV in rao \u2014 the fund's headline mark."
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "weights": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "The validator's allocation vector, as set by `set_root_weights`.",
              "required": [
                "netuid",
                "weight"
              ],
              "properties": {
                "netuid": {
                  "type": "integer",
                  "format": "int32"
                },
                "weight": {
                  "type": "integer",
                  "format": "int32",
                  "description": "Raw u16 weight. Normalise against the vector's total for a share."
                }
              }
            }
          }
        }
      }
    },
    "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

Section titled “400 — Bad request”

500 — Internal server error

Section titled “500 — Internal server error”

Authentication

Section titled “Authentication”

All Taostats API requests require an Authorization header containing your API key. See Getting Started.