Documentation / API reference / Validator
Get Validator dTAO
Reference
Last reviewed 2026-09-18
Returns the latest validator overview, including Root stake, Alpha stake valued in TAO, nominators and dominance. Records also include active subnets, ranks, validator take and daily returns.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
hotkey | query | string | SS58 or hex format | |
page | query | integer (int32) | The page number of the response. | |
limit | query | integer (int32) | The number of responses. max is 200, | |
order | query | string | One of active_subnets_asc, active_subnets_desc, rank_asc, rank_desc, root_rank_asc, root_rank_desc, alpha_rank_asc, alpha_rank_desc, take_asc, take_desc, global_nominators_asc, global_nominators_desc, global_weighted_stake_asc, global_weighted_stake_desc, global_alpha_stake_as_tao_asc, global_alpha_stake_as_tao_desc, weighted_root_stake_asc, weighted_root_stake_desc, root_stake_asc, root_stake_desc, dominance_asc, dominance_desc. |
Responses
200 — Validators retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].active_subnets | integer (int32) | Yes | |
data[].alpha_rank | integer (int32) | Yes | |
data[].block_number | integer (int32) | Yes | |
data[].claim_types | array | Yes | |
data[].claim_types[] | ClaimType | Yes | |
data[].coldkey | object | Yes | |
data[].coldkey.hex | string | Yes | The hex format of the hot key |
data[].coldkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].created_on_date | string (date) | Yes | |
data[].dominance | string | Yes | |
data[].dominance_24_hr_change | string | Yes | |
data[].global_alpha_stake_as_tao | string | Yes | |
data[].global_nominators | integer (int32) | Yes | |
data[].global_nominators_24_hr_change | integer (int32) | Yes | |
data[].global_weighted_stake | string | Yes | |
data[].global_weighted_stake_24_hr_change | string | Yes | |
data[].hotkey | object | Yes | |
data[].hotkey.hex | string | Yes | The hex format of the hot key |
data[].hotkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].name | string, nullable | ||
data[].nominator_return_per_day | string | Yes | |
data[].rank | integer (int32) | Yes | |
data[].root_rank | integer (int32) | Yes | |
data[].root_stake | string | Yes | |
data[].take | string | Yes | |
data[].timestamp | string (date-time) | Yes | |
data[].validator_return_per_day | string | Yes | |
data[].weighted_root_stake | string | Yes | |
pagination | object | Yes | |
pagination.current_page | integer (int32) | Yes | |
pagination.next_page | integer (int32), nullable | ||
pagination.per_page | integer (int32) | Yes | |
pagination.prev_page | integer (int32), nullable | ||
pagination.total_items | integer (int32) | Yes | |
pagination.total_pages | integer (int32) | Yes |
Example response
json
{
"data": [
{
"apr": "0.1226914838257602856",
"apr_30_day_average": "0.129796838605",
"apr_7_day_average": "0.12447917149",
"block_number": 4107250,
"blocks_until_next_reward": 3636,
"coldkey": {
"hex": "0xe2a8d08674697d6ee2ccec36f0e207653788275b619392256e509be04d32950d",
"ss58": "5HBtpwxuGNL1gwzwomwR7sjwUt8WXYSuWcLYN6f9KpTZkP4k"
},
"dominance": "14.75594365873212499149",
"hotkey": {
"hex": "0x84d83d08ca89f8e60424ffa286f165c16dd8752e4faa4d8977221e6720678d28",
"ss58": "5F4tQyWrhfGVcNhoqeiNsR6KjD4wMZ2kfhLj4oHYuyHbZAc3"
},
"last_reward_block": 4103686,
"name": "Openτensor Foundaτion",
"nominator_return_per_k": "336141052",
"nominator_return_per_k_30_day_average": "355607777",
"nominator_return_per_k_7_day_average": "341038826",
"nominators": 8695,
"nominators_24_hr_change": 2,
"pending_emission": "179159780106",
"permits": [
0,
1
],
"rank": 1,
"registrations": [
0,
1
],
"stake": "876338463769258",
"stake_24_hr_change": "-1199511103826",
"subnet_dominance": [
{
"dominance": "14.75594365873212499149",
"family_stake": "876338463769258",
"netuid": 0
},
{
"dominance": "13.2803492928589091247",
"family_stake": "788704617392332",
"netuid": 1
}
],
"system_stake": "5938884588046439",
"take": "0.17999542229343099107",
"timestamp": "2024-10-23T16:35:36.007Z",
"total_daily_return": "359233766198",
"validator_return": "64660433449",
"validator_stake": "64382133439699"
},
{
"apr": "0.1488383441509764504",
"apr_30_day_average": "0.154848964005",
"apr_7_day_average": "0.15118296715",
"block_number": 4107250,
"blocks_until_next_reward": 3858,
"coldkey": {
"hex": "0xc8f623c92b47ac9645d6744f3d448cdb7a2a3b08a22a39bfd1db0afbd9c07117",
"ss58": "5GcCZ2BPXBjgG88tXJCEtkbdg2hNrPbL4EFfbiVRvBZdSQDC"
},
"dominance": "13.67140387390491813267",
"hotkey": {
"hex": "0xbc0e6b701243978c1fe73d721c7b157943a713fca9f3c88cad7a9f7799bc6b26",
"ss58": "5GKH9FPPnWSUoeeTJp19wVtd84XqFW4pyK2ijV2GsFbhTrP1"
},
"last_reward_block": 4103908,
"name": "Taostats & Corcel",
"nominator_return_per_k": "407776285",
"nominator_return_per_k_30_day_average": "424243737",
"nominator_return_per_k_7_day_average": "414199910",
"nominators": 5855,
"nominators_24_hr_change": 23,
"pending_emission": "165052485137",
"permits": [
0,
1
],
"rank": 2,
"registrations": [
0,
1
],
"stake": "811928897636923",
"stake_24_hr_change": "2996381851749",
"subnet_dominance": [
{
"dominance": "13.67140387390491813267",
"family_stake": "811928897636923",
"netuid": 0
},
{
"dominance": "15.48150213219727827492",
"family_stake": "919428544127145",
"netuid": 1
}
],
"system_stake": "5938884588046439",
"take": "0.08999771114671549554",
"timestamp": "2024-10-23T16:35:36.007Z",
"total_daily_return": "363829139661",
"validator_return": "32743789818",
"validator_stake": "168368353255"
}
],
"pagination": {
"current_page": 1,
"next_page": 2,
"per_page": 50,
"prev_page": null,
"total_items": 473,
"total_pages": 10
}
}Response details
text
{
"hotkey": {
"ss58": "5GKH9FPPnWSUoeeTJp19wVtd84XqFW4pyK2ijV2GsFbhTrP1",
"hex": "0xbc0e6b701243978c1fe73d721c7b157943a713fca9f3c88cad7a9f7799bc6b26"
},
"coldkey": {
"ss58": "5GcCZ2BPXBjgG88tXJCEtkbdg2hNrPbL4EFfbiVRvBZdSQDC",
"hex": "0xc8f623c92b47ac9645d6744f3d448cdb7a2a3b08a22a39bfd1db0afbd9c07117"
},
"name": "Taostats & Corcel",
"block_number": 5453927,
"timestamp": "2025-04-29T00:19:00Z",
"created_on_date": "2025-02-13",
"rank": 1,
"root_rank": 1,
"alpha_rank": 1,
"active_subnets": 88,
"global_nominators": 28224,
"global_nominators_24_hr_change": 103,
"take": "0.08999771114671549554",
"global_weighted_stake": "295814209201488", as rao
"global_weighted_stake_24_hr_change": "-7812357318085",as rao
"global_alpha_stake_as_tao": "152287191316855",as rao
"root_stake": "797372321581294",as rao
"weighted_root_stake": "143527017884633",as rao
"dominance": "14.10",
"dominance_24_hr_change": "0.04",
"nominator_return_per_day": "790856951071",as rao
"validator_return_per_day": "78214435626"as rao
},Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Validators not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.