Skip to content

Get Validator (dTao)

GET /api/dtao/validator/latest/v1
NameInTypeRequiredDescription
hotkeyquerystringSS58 or hex format
pagequeryintegerThe page number of the response.
limitqueryintegerThe number of responses. max is 200,
orderquery

Media: application/json

Schema
{
"type": "object",
"required": [
"pagination",
"data"
],
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"required": [
"hotkey",
"coldkey",
"block_number",
"timestamp",
"created_on_date",
"rank",
"root_rank",
"alpha_rank",
"active_subnets",
"global_nominators",
"global_nominators_24_hr_change",
"take",
"global_weighted_stake",
"global_weighted_stake_24_hr_change",
"global_alpha_stake_as_tao",
"root_stake",
"weighted_root_stake",
"dominance",
"dominance_24_hr_change",
"nominator_return_per_day",
"validator_return_per_day",
"claim_types"
],
"properties": {
"active_subnets": {
"type": "integer",
"format": "int32"
},
"alpha_rank": {
"type": "integer",
"format": "int32"
},
"block_number": {
"type": "integer",
"format": "int32"
},
"claim_types": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ClaimType"
}
},
"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"
}
}
},
"created_on_date": {
"type": "string",
"format": "date"
},
"dominance": {
"type": "string"
},
"dominance_24_hr_change": {
"type": "string"
},
"global_alpha_stake_as_tao": {
"type": "string"
},
"global_nominators": {
"type": "integer",
"format": "int32"
},
"global_nominators_24_hr_change": {
"type": "integer",
"format": "int32"
},
"global_weighted_stake": {
"type": "string"
},
"global_weighted_stake_24_hr_change": {
"type": "string"
},
"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"
}
}
},
"name": {
"type": "string",
"nullable": true
},
"nominator_return_per_day": {
"type": "string"
},
"rank": {
"type": "integer",
"format": "int32"
},
"root_rank": {
"type": "integer",
"format": "int32"
},
"root_stake": {
"type": "string"
},
"take": {
"type": "string"
},
"timestamp": {
"type": "string",
"format": "date-time"
},
"validator_return_per_day": {
"type": "string"
},
"weighted_root_stake": {
"type": "string"
}
}
}
},
"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"
}
}
}
}
}
Examples
{
"Result": {
"value": "{\n \"pagination\": {\n \"current_page\": 1,\n \"per_page\": 50,\n \"total_items\": 473,\n \"total_pages\": 10,\n \"next_page\": 2,\n \"prev_page\": null\n },\n \"data\": [\n {\n \"hotkey\": {\n \"ss58\": \"5F4tQyWrhfGVcNhoqeiNsR6KjD4wMZ2kfhLj4oHYuyHbZAc3\",\n \"hex\": \"0x84d83d08ca89f8e60424ffa286f165c16dd8752e4faa4d8977221e6720678d28\"\n },\n \"coldkey\": {\n \"ss58\": \"5HBtpwxuGNL1gwzwomwR7sjwUt8WXYSuWcLYN6f9KpTZkP4k\",\n \"hex\": \"0xe2a8d08674697d6ee2ccec36f0e207653788275b619392256e509be04d32950d\"\n },\n \"name\": \"Open\u03c4ensor Founda\u03c4ion\",\n \"block_number\": 4107250,\n \"timestamp\": \"2024-10-23T16:35:36.007Z\",\n \"rank\": 1,\n \"nominators\": 8695,\n \"nominators_24_hr_change\": 2,\n \"system_stake\": \"5938884588046439\",\n \"stake\": \"876338463769258\",\n \"stake_24_hr_change\": \"-1199511103826\",\n \"dominance\": \"14.75594365873212499149\",\n \"validator_stake\": \"64382133439699\",\n \"take\": \"0.17999542229343099107\",\n \"total_daily_return\": \"359233766198\",\n \"validator_return\": \"64660433449\",\n \"nominator_return_per_k\": \"336141052\",\n \"apr\": \"0.1226914838257602856\",\n \"nominator_return_per_k_7_day_average\": \"341038826\",\n \"nominator_return_per_k_30_day_average\": \"355607777\",\n \"apr_7_day_average\": \"0.12447917149\",\n \"apr_30_day_average\": \"0.129796838605\",\n \"pending_emission\": \"179159780106\",\n \"blocks_until_next_reward\": 3636,\n \"last_reward_block\": 4103686,\n \"registrations\": [\n 0,\n 1,\n 2,\n 3,\n 5,\n 6,\n 7,\n 8,\n 9,\n 10,\n 11,\n 12,\n 13,\n 14,\n 15,\n 16,\n 17,\n 18,\n 19,\n 20,\n 21,\n 22,\n 23,\n 24,\n 25,\n 26,\n 27,\n 28,\n 29,\n 30,\n 31,\n 32,\n 33,\n 34,\n 35,\n 39,\n 40,\n 41,\n 42,\n 43,\n 44,\n 45,\n 48\n ],\n \"permits\": [\n 0,\n 1,\n 2,\n 3,\n 5,\n 6,\n 7,\n 8,\n 9,\n 10,\n 11,\n 12,\n 13,\n 14,\n 15,\n 16,\n 17,\n 18,\n 19,\n 20,\n 21,\n 22,\n 23,\n 24,\n 25,\n 26,\n 27,\n 28,\n 29,\n 30,\n 31,\n 32,\n 33,\n 34,\n 35,\n 39,\n 40,\n 41,\n 42,\n 43,\n 44,\n 45,\n 48\n ],\n \"subnet_dominance\": [\n {\n \"netuid\": 0,\n \"dominance\": \"14.75594365873212499149\",\n \"family_stake\": \"876338463769258\"\n },\n {\n \"netuid\": 1,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 2,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 3,\n \"dominance\": \"17.61769868508137637693\",\n \"family_stake\": \"1046294791976758\"\n },\n {\n \"netuid\": 4,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 5,\n \"dominance\": \"16.14210431920816051014\",\n \"family_stake\": \"958660945599832\"\n },\n {\n \"netuid\": 6,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 7,\n \"dominance\": \"17.6400885827977655804\",\n \"family_stake\": \"1047624502161516\"\n },\n {\n \"netuid\": 8,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 9,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 10,\n \"dominance\": \"13.30273919057529832818\",\n \"family_stake\": \"790034327577090\"\n },\n {\n \"netuid\": 11,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 26,\n \"dominance\": \"17.61769868508137637693\",\n \"family_stake\": \"1046294791976758\"\n },\n {\n \"netuid\": 12,\n \"dominance\": \"30.14700464271697735363\",\n \"family_stake\": \"1790395812483963\"\n },\n {\n \"netuid\": 13,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 14,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 15,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 16,\n \"dominance\": \"17.61769868508137637693\",\n \"family_stake\": \"1046294791976758\"\n },\n {\n \"netuid\": 17,\n \"dominance\": \"13.30273919057529832818\",\n \"family_stake\": \"790034327577090\"\n },\n {\n \"netuid\": 18,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 19,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 20,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 21,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 22,\n \"dominance\": \"17.6400885827977655804\",\n \"family_stake\": \"1047624502161516\"\n },\n {\n \"netuid\": 23,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 24,\n \"dominance\": \"13.30273919057529832818\",\n \"family_stake\": \"790034327577090\"\n },\n {\n \"netuid\": 25,\n \"dominance\": \"11.80475492698569325792\",\n \"family_stake\": \"701070771015406\"\n },\n {\n \"netuid\": 27,\n \"dominance\": \"17.61769868508137637693\",\n \"family_stake\": \"1046294791976758\"\n },\n {\n \"netuid\": 28,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 29,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 30,\n \"dominance\": \"17.61769868508137637693\",\n \"family_stake\": \"1046294791976758\"\n },\n {\n \"netuid\": 31,\n \"dominance\": \"13.30273919057529832818\",\n \"family_stake\": \"790034327577090\"\n },\n {\n \"netuid\": 32,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 33,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 34,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 35,\n \"dominance\": \"17.61769868508137637693\",\n \"family_stake\": \"1046294791976758\"\n },\n {\n \"netuid\": 36,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 37,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 38,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 39,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 40,\n \"dominance\": \"17.6400885827977655804\",\n \"family_stake\": \"1047624502161516\"\n },\n {\n \"netuid\": 41,\n \"dominance\": \"17.61769868508137637693\",\n \"family_stake\": \"1046294791976758\"\n },\n {\n \"netuid\": 42,\n \"dominance\": \"17.61769868508137637693\",\n \"family_stake\": \"1046294791976758\"\n },\n {\n \"netuid\": 43,\n \"dominance\": \"13.2803492928589091247\",\n \"family_stake\": \"788704617392332\"\n },\n {\n \"netuid\": 44,\n \"dominance\": \"17.61769868508137637693\",\n \"family_stake\": \"1046294791976758\"\n },\n {\n \"netuid\": 45,\n \"dominance\": \"17.61769868508137637693\",\n \"family_stake\": \"1046294791976758\"\n },\n {\n \"netuid\": 46,\n \"dominance\": \"14.75594365873212499149\",\n \"family_stake\": \"876338463769258\"\n },\n {\n \"netuid\": 47,\n \"dominance\": \"14.75594365873212499149\",\n \"family_stake\": \"876338463769258\"\n },\n {\n \"netuid\": 48,\n \"dominance\": \"19.09329305095459224371\",\n \"family_stake\": \"1133928638353684\"\n },\n {\n \"netuid\": 49,\n \"dominance\": \"14.75594365873212499149\",\n \"family_stake\": \"876338463769258\"\n },\n {\n \"netuid\": 50,\n \"dominance\": \"14.75594365873212499149\",\n \"family_stake\": \"876338463769258\"\n },\n {\n \"netuid\": 51,\n \"dominance\": \"4.33734939222246725223\",\n \"family_stake\": \"257590174584426\"\n },\n {\n \"netuid\": 52,\n \"dominance\": \"14.75594365873212499149\",\n \"family_stake\": \"876338463769258\"\n }\n ]\n },\n {\n \"hotkey\": {\n \"ss58\": \"5GKH9FPPnWSUoeeTJp19wVtd84XqFW4pyK2ijV2GsFbhTrP1\",\n \"hex\": \"0xbc0e6b701243978c1fe73d721c7b157943a713fca9f3c88cad7a9f7799bc6b26\"\n },\n \"coldkey\": {\n \"ss58\": \"5GcCZ2BPXBjgG88tXJCEtkbdg2hNrPbL4EFfbiVRvBZdSQDC\",\n \"hex\": \"0xc8f623c92b47ac9645d6744f3d448cdb7a2a3b08a22a39bfd1db0afbd9c07117\"\n },\n \"name\": \"Taostats & Corcel\",\n \"block_number\": 4107250,\n \"timestamp\": \"2024-10-23T16:35:36.007Z\",\n \"rank\": 2,\n \"nominators\": 5855,\n \"nominators_24_hr_change\": 23,\n \"system_stake\": \"5938884588046439\",\n \"stake\": \"811928897636923\",\n \"stake_24_hr_change\": \"2996381851749\",\n \"dominance\": \"13.67140387390491813267\",\n \"validator_stake\": \"168368353255\",\n \"take\": \"0.08999771114671549554\",\n \"total_daily_return\": \"363829139661\",\n \"validator_return\": \"32743789818\",\n \"nominator_return_per_k\": \"407776285\",\n \"apr\": \"0.1488383441509764504\",\n \"nominator_return_per_k_7_day_average\": \"414199910\",\n \"nominator_return_per_k_30_day_average\": \"424243737\",\n \"apr_7_day_average\": \"0.15118296715\",\n \"apr_30_day_average\": \"0.154848964005\",\n \"pending_emission\": \"165052485137\",\n \"blocks_until_next_reward\": 3858,\n \"last_reward_block\": 4103908,\n \"registrations\": [\n 0,\n 1,\n 2,\n 3,\n 4,\n 5,\n 6,\n 7,\n 8,\n 9,\n 10,\n 11,\n 12,\n 13,\n 14,\n 15,\n 16,\n 17,\n 18,\n 19,\n 20,\n 21,\n 22,\n 23,\n 24,\n 25,\n 26,\n 27,\n 28,\n 29,\n 30,\n 31,\n 32,\n 33,\n 34,\n 35,\n 36,\n 37,\n 38,\n 39,\n 40,\n 41,\n 42,\n 43,\n 44,\n 45,\n 46,\n 47,\n 48,\n 49,\n 50,\n 51,\n 52\n ],\n \"permits\": [\n 0,\n 1,\n 2,\n 3,\n 4,\n 5,\n 6,\n 7,\n 8,\n 9,\n 10,\n 11,\n 12,\n 13,\n 14,\n 15,\n 16,\n 17,\n 18,\n 19,\n 20,\n 21,\n 22,\n 23,\n 24,\n 25,\n 26,\n 27,\n 28,\n 29,\n 30,\n 31,\n 32,\n 33,\n 34,\n 35,\n 37,\n 38,\n 39,\n 40,\n 41,\n 42,\n 43,\n 44,\n 45,\n 46,\n 48,\n 49,\n 50,\n 51,\n 52\n ],\n \"subnet_dominance\": [\n {\n \"netuid\": 0,\n \"dominance\": \"13.67140387390491813267\",\n \"family_stake\": \"811928897636923\"\n },\n {\n \"netuid\": 1,\n \"dominance\": \"15.48150213219727827492\",\n \"family_stake\": \"919428544127145\"\n },\n {\n \"netuid\": 2,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 3,\n \"dominance\": \"15.1239944677374082052\",\n \"family_stake\": \"898196576541453\"\n },\n {\n \"netuid\": 4,\n \"dominance\": \"8.28829253078494071977\",\n \"family_stake\": \"492232127722991\"\n },\n {\n \"netuid\": 5,\n \"dominance\": \"15.1239944677374082052\",\n \"family_stake\": \"898196576541453\"\n },\n {\n \"netuid\": 6,\n \"dominance\": \"15.1239944677374082052\",\n \"family_stake\": \"898196576541453\"\n },\n {\n \"netuid\": 7,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 8,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 9,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 10,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 11,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 26,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 12,\n \"dominance\": \"15.16947071197209211529\",\n \"family_stake\": \"900897358201529\"\n },\n {\n \"netuid\": 13,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 14,\n \"dominance\": \"19.98625094273072250052\",\n \"family_stake\": \"1186960376966121\"\n },\n {\n \"netuid\": 15,\n \"dominance\": \"15.1239944677374082052\",\n \"family_stake\": \"898196576541453\"\n },\n {\n \"netuid\": 16,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 17,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 18,\n \"dominance\": \"15.1239944677374082052\",\n \"family_stake\": \"898196576541453\"\n },\n {\n \"netuid\": 19,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 20,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 21,\n \"dominance\": \"16.76552845336745001992\",\n \"family_stake\": \"995685385421580\"\n },\n {\n \"netuid\": 22,\n \"dominance\": \"15.1239944677374082052\",\n \"family_stake\": \"898196576541453\"\n },\n {\n \"netuid\": 23,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 24,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 25,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 27,\n \"dominance\": \"15.1239944677374082052\",\n \"family_stake\": \"898196576541453\"\n },\n {\n \"netuid\": 28,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 29,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 30,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 31,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 32,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 33,\n \"dominance\": \"15.1239944677374082052\",\n \"family_stake\": \"898196576541453\"\n },\n {\n \"netuid\": 34,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 35,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 36,\n \"dominance\": \"14.24420622773393981082\",\n \"family_stake\": \"845946968348442\"\n },\n {\n \"netuid\": 37,\n \"dominance\": \"14.28968247196862372091\",\n \"family_stake\": \"848647750008518\"\n },\n {\n \"netuid\": 38,\n \"dominance\": \"14.22181633001755060734\",\n \"family_stake\": \"844617258163684\"\n },\n {\n \"netuid\": 39,\n \"dominance\": \"22.80317501485419392283\",\n \"family
/* … truncated, full schema in /api/openapi.json */

Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).

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