Get Validator History (dTao)
Endpoint
Section titled “Endpoint”GET /api/dtao/validator/history/v1Parameters
Section titled “Parameters”| Name | In | Type | Required | Description |
|---|---|---|---|---|
hotkey | query | string | SS58 or hex format | |
block_number | query | integer | The exact block number | |
block_start | query | integer | Start of block range (inclusive) | |
block_end | query | integer | End of block range (inclusive) | |
timestamp_start | query | integer | Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | |
timestamp_end | query | integer | End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | |
page | query | integer | The page number of the response. | |
limit | query | integer | The number of responses. max is 200, | |
order | query | — |
Responses
Section titled “Responses”200 — Validators retrieved successfully
Section titled “200 — Validators retrieved successfully”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\": 146186,\n \"total_pages\": 2924,\n \"next_page\": 2,\n \"prev_page\": null\n },\n \"data\": [\n {\n \"hotkey\": {\n \"ss58\": \"5GcBK8PDrVifV1xAf4Qkkk6KsbsmhDdX9atvk8vyKU8xdU63\",\n \"hex\": \"0xc8f1f79693409717186537848672035443b08120d10c026c1ba748fa693e7175\"\n },\n \"coldkey\": {\n \"ss58\": \"5EsyFEexqVRqaYymJmkmjDg55Lvr6ucbB22ZYDuSD9oVQgq1\",\n \"hex\": \"0x7c84ce22fc340f51c1ee66c7de67a987a34dbd427e4f0efca19997b87092995d\"\n },\n \"name\": \"Tensor.Exchange\",\n \"block_number\": 4107500,\n \"timestamp\": \"2024-10-23T17:25:36.001Z\",\n \"rank\": 30,\n \"nominators\": 125,\n \"nominators_24_hr_change\": 0,\n \"system_stake\": \"5938089019868528\",\n \"stake\": \"1743770436061\",\n \"stake_24_hr_change\": \"-1000000000\",\n \"dominance\": \"0.0293658520481326141\",\n \"validator_stake\": \"960376\",\n \"take\": \"0.17999542229343099107\",\n \"total_daily_return\": \"0\",\n \"validator_return\": \"0\",\n \"nominator_return_per_k\": \"0\",\n \"apr\": \"0\",\n \"nominator_return_per_k_7_day_average\": \"0\",\n \"nominator_return_per_k_30_day_average\": \"0\",\n \"apr_7_day_average\": \"0\",\n \"apr_30_day_average\": \"0\",\n \"registrations\": [\n 0,\n 5,\n 6,\n 11,\n 12,\n 23,\n 24,\n 29,\n 30,\n 32\n ],\n \"permits\": [\n 0\n ],\n \"subnet_dominance\": [\n {\n \"netuid\": 0,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 1,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 2,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 3,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 4,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 5,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 6,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 7,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 8,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 9,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 10,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 11,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 26,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 12,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 13,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 14,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 15,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 16,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 17,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 18,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 19,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 20,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 21,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 22,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 23,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 24,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 25,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 27,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 28,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 29,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 30,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 31,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 32,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 33,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 34,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 35,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 36,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 37,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 38,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 39,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 40,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 41,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 42,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 43,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 44,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 45,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 46,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 47,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 48,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 49,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 50,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 51,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n },\n {\n \"netuid\": 52,\n \"dominance\": \"0.0293658520481326141\",\n \"family_stake\": \"1743770436061\"\n }\n ]\n },\n {\n \"hotkey\": {\n \"ss58\": \"5F1VvZU6JA77jh3DPPh3zfZs14wcVnoDcXTBFj69XwkXrpQK\",\n \"hex\": \"0x8242cb5f830f90300470552bf794756c10cfd138cec21b3199ec3fd1c84e5623\"\n },\n \"coldkey\": {\n \"ss58\": \"5H48ZNbRjpmGu4qyNKN9jrBqpeCZFZfVqvZZ9WEoL3nZ8Ef4\",\n \"hex\": \"0xdcbd1355ecc8c7d3c6b6638a8e799090a0ce3e0a0ba2b4633ba431ad2fa02147\"\n },\n \"name\": null,\n \"block_number\": 4107500,\n \"timestamp\": \"2024-10-23T17:25:36.001Z\",\n \"rank\": 446,\n \"nominators\": 0,\n \"nominators_24_hr_change\": 0,\n \"system_stake\": \"5938089019868528\",\n \"stake\": \"0\",\n \"stake_24_hr_change\": \"0\",\n \"dominance\": \"0\",\n \"validator_stake\": \"0\",\n \"take\": \"0.17999542229343099107\",\n \"total_daily_return\": \"0\",\n \"validator_return\": \"0\",\n \"nominator_return_per_k\": \"0\",\n \"apr\": \"0\",\n \"nominator_return_per_k_7_day_average\": \"0\",\n \"nominator_return_per_k_30_day_average\": \"0\",\n \"apr_7_day_average\": \"0\",\n \"apr_30_day_average\": \"0\",\n \"registrations\": [],\n \"permits\": [],\n \"subnet_dominance\": [\n {\n \"netuid\": 0,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 1,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 2,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 3,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 4,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 5,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 6,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 7,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 8,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 9,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 10,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 11,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 26,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 12,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 13,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 14,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 15,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 16,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 17,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 18,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 19,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 20,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 21,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 22,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 23,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 24,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 25,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 27,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 28,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 29,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 30,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 31,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 32,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 33,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 34,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 35,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 36,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 37,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 38,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 39,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 40,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 41,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 42,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 43,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 44,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 45,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 46,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 47,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 48,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 49,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 50,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 51,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n },\n {\n \"netuid\": 52,\n \"dominance\": \"0\",\n \"family_stake\": \"0\"\n }\n ]\n },\n {\n \"hotkey\": {\n \"ss58\": \"5HK5tp6t2S59DywmHRWPBVJeJ86T61KjurYqeooqj8sREpeN\",\n \"hex\": \"0xe824c935940357af73c961bdd7387e1ab821ec2939ecd19daafe6081ae9ae674\"\n },\n \"coldkey\": {\n \"ss58\": \"5CAwB3dSiMC5jJfpvVU47zT3Gyz5ZDoiyHMaYZUuNs5hFh2P\",\n \"hex\": \"0x04c04d0aab0229a3e43fb5b00680932d53dee07d2756519fd72b2a81e6759163\"\n },\n \"name\": \"Bittensor Guru\",\n \"block_number\": 4107500,\n \"timestamp\": \"2024-10-23T17:25:36.001Z\",\n \"rank\": 7,\n \"nominators\": 1096,\n \"nominators_24_hr_change\": -3,\n \"system_stake\": \"5938089019868528\",\n \"stake\": \"303877830426996\",\n \"stake_24_hr_change\": \"-509173245280\",\n \"dominance\": \"5.11743474054088858712\",\n \"validator_stake\": \"1518270132382\",\n \"take\": \"0.08999771114671549554\",\n \"total_daily_return\": \"125733287508\",\n \"validator_return\": \"11315708091\",\n \"nominator_return_per_k\": \"376524932\",\n \"apr\": \"0.137431600155181606\",\n \"nominator_return_per_k_7_day_average\": \"397673716\",\n \"nominator_return_per_k_30_day_average\": \"401017629\",\n \"apr_7_day_average\": \"0.14515090634\",\n \"apr_30_day_average\": \"0.146371434585\",\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 48,\n 50,\n 51\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 48,\n 50,\n 51\n ],\n \"subnet_dominance\": [\n {\n \"netuid\": 0,\n \"dominance\": \"5.11743474054088858712\",\n \"family_stake\": \"303877830426996\"\n },\n {\n \"n
/* … truncated, full schema in /api/openapi.json */400 — Bad request
Section titled “400 — Bad request”404 — Validators not found
Section titled “404 — Validators not found”500 — Internal server error
Section titled “500 — Internal server error”Try it
Section titled “Try it”Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).
Authentication
Section titled “Authentication”All Taostats API requests require an Authorization header containing your API key. See Getting Started.