Documentation / API reference / Validator
Get Validator Dividends Latest
Reference
Last reviewed 2026-09-18
Returns the latest validator and nominator dividends for Alpha and Root stake by subnet. Records also include stake totals, validator take, epochs and nominator returns.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
hotkey | query | string | SS58 or hex format | |
netuid | query | integer (int32) | ||
page | query | integer (int32) | ||
limit | query | integer (int32) | ||
order | query | string | One of netuid_asc, netuid_desc, take_asc, take_desc, total_hotkey_alpha_asc, total_hotkey_alpha_desc, total_hotkey_root_asc, total_hotkey_root_desc, nominator_alpha_dividends_asc, nominator_alpha_dividends_desc, validator_alpha_dividends_asc, validator_alpha_dividends_desc, nominator_root_dividends_asc, nominator_root_dividends_desc, validator_root_dividends_asc, validator_root_dividends_desc, nominator_return_per_day_per_k_t_alpha_asc, nominator_return_per_day_per_k_t_alpha_desc, nominator_return_per_day_per_k_t_root_asc, nominator_return_per_day_per_k_t_root_desc. |
Responses
200 — Validators retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].block_number | integer (int32) | Yes | |
data[].day | string (date) | Yes | |
data[].epochs | integer (int32) | 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[].netuid | integer (int32) | Yes | |
data[].nominator_alpha_dividends | string | Yes | |
data[].nominator_return_per_kt_alpha | string | Yes | |
data[].nominator_return_per_kt_root | string | Yes | |
data[].nominator_root_dividends | string | Yes | |
data[].take | string | Yes | |
data[].tempo | integer (int32) | Yes | |
data[].timestamp | string (date-time) | Yes | |
data[].total_hotkey_alpha | string | Yes | |
data[].total_hotkey_root | string | Yes | |
data[].validator_alpha_dividends | string | Yes | |
data[].validator_root_dividends | 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 |
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.