Get Validator Metrics
Endpoint
Section titled “Endpoint”GET /api/validator/metrics/latest/v1Try it
Section titled “Try it”Parameters
Section titled “Parameters”| Name | In | Type | Required | Description |
|---|---|---|---|---|
hotkey | query | string | SS58 or hex format | |
coldkey | query | string | SS58 or hex format | |
netuid | query | integer | subnet | |
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 — Validator metrics retrieved successfully
Section titled “200 — Validator metrics retrieved successfully”Media: application/json
Schema
{ "type": "object", "required": [ "pagination", "data" ], "properties": { "data": { "type": "array", "items": { "type": "object", "required": [ "coldkey", "hotkey", "netuid", "uid", "block_number", "timestamp", "active", "validator_permit", "is_immunity_period", "updated", "registered_block_number", "rank", "validator_trust", "stake", "emission", "daily_reward", "incentive", "consensus", "dividends", "trust" ], "properties": { "active": { "type": "boolean" }, "axon_info": { "nullable": true }, "block_number": { "type": "integer", "format": "int32" }, "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" } } }, "consensus": { "type": "string" }, "daily_reward": { "type": "string" }, "dividends": { "type": "string" }, "emission": { "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" } } }, "incentive": { "type": "string" }, "is_immunity_period": { "type": "boolean" }, "netuid": { "type": "integer", "format": "int32" }, "rank": { "type": "integer", "format": "int32" }, "registered_block_number": { "type": "integer", "format": "int32" }, "stake": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" }, "trust": { "type": "string" }, "uid": { "type": "integer", "format": "int32" }, "updated": { "type": "integer", "format": "int32" }, "validator_permit": { "type": "boolean" }, "validator_trust": { "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\": 5,\n \"total_items\": 12974,\n \"total_pages\": 2595,\n \"next_page\": 2,\n \"prev_page\": null\n },\n \"data\": [\n {\n \"coldkey\": {\n \"ss58\": \"5GhCP4Ss4XyiMYS4asHP6jN9EcjnAU79sjRhDWtP41CPEL4y\",\n \"hex\": \"0xccc5c9e70f63d5475d61cdce984668958c68a8c0ee528b0537e79f9e63c9e50a\"\n },\n \"hotkey\": {\n \"ss58\": \"5FBvGUf3FhJfzLnDKwHCVqtycVzuK4uLqmx1dyYd4xFpP8Th\",\n \"hex\": \"0x8a35321620fbc616fb51ce20489c8069cc83963cc9a8f6ae0f1e7a6b533a1755\"\n },\n \"netuid\": 0,\n \"uid\": 44,\n \"block_number\": 4107535,\n \"timestamp\": \"2024-10-23T17:32:36.002Z\",\n \"active\": false,\n \"validator_permit\": true,\n \"is_immunity_period\": false,\n \"updated\": 2697606,\n \"registered_block_number\": 1409929,\n \"rank\": 52,\n \"validator_trust\": \"0\",\n \"stake\": \"1176549717\",\n \"emission\": \"0\",\n \"daily_reward\": \"0\",\n \"incentive\": \"0.00160219729915312428\",\n \"consensus\": \"0.00120546272983901732\",\n \"dividends\": \"0\",\n \"trust\": \"0.22493324177920195315\",\n \"axon_info\": null\n },\n {\n \"coldkey\": {\n \"ss58\": \"5CrBAGHUxUdj91kJZw8FAqA2USvksttNFgcMbfSfmqPcTu8t\",\n \"hex\": \"0x22adf45cbc3509a7f99ad9379745afe94874f75c28a2aa2f719a18859b5b9f78\"\n },\n \"hotkey\": {\n \"ss58\": \"5ED6jwDECEmNvSp98R2qyEUPHDv9pi14E6n3TS8CicD6YfhL\",\n \"hex\": \"0x5edf76d8d5f40da1e4336f8a051f3fbcfd53ac7387dbf12eee67507ac7dc747e\"\n },\n \"netuid\": 0,\n \"uid\": 32,\n \"block_number\": 4107535,\n \"timestamp\": \"2024-10-23T17:32:36.002Z\",\n \"active\": false,\n \"validator_permit\": true,\n \"is_immunity_period\": false,\n \"updated\": 860026,\n \"registered_block_number\": 1405120,\n \"rank\": 24,\n \"validator_trust\": \"0.00114442664225223163\",\n \"stake\": \"9869487004953\",\n \"emission\": \"0\",\n \"daily_reward\": \"0\",\n \"incentive\": \"0.00381475547417410544\",\n \"consensus\": \"0.00286869611657892729\",\n \"dividends\": \"0\",\n \"trust\": \"0.20991836423285267414\",\n \"axon_info\": null\n },\n {\n \"coldkey\": {\n \"ss58\": \"5CBCdaA8DcU7S5QC82KjvFptZUASV3Fjxg4atoyzT6XkLWoQ\",\n \"hex\": \"0x04f455c444fff42d7d9c24da44797404d924b9af6fb73cb3f11638c81868fc7d\"\n },\n \"hotkey\": {\n \"ss58\": \"5EpxBYq4aVgTQ1rYeBo2mzYt3hgpRTqxZTSsJEkCstBP5Jse\",\n \"hex\": \"0x7a377d1dcefae38c34dc9b79b695901a0c57fbc10c733688ea0397719802a758\"\n },\n \"netuid\": 0,\n \"uid\": 53,\n \"block_number\": 4107535,\n \"timestamp\": \"2024-10-23T17:32:36.002Z\",\n \"active\": false,\n \"validator_permit\": true,\n \"is_immunity_period\": false,\n \"updated\": 2450347,\n \"registered_block_number\": 1440142,\n \"rank\": 50,\n \"validator_trust\": \"0\",\n \"stake\": \"1315880608\",\n \"emission\": \"0\",\n \"daily_reward\": \"0\",\n \"incentive\": \"0\",\n \"consensus\": \"0\",\n \"dividends\": \"0\",\n \"trust\": \"0\",\n \"axon_info\": null\n },\n {\n \"coldkey\": {\n \"ss58\": \"5DkwfxC9mZTTCsRUt6nrnwQEWVrhsmY13SBRparj6cpAVxVY\",\n \"hex\": \"0x4aec8e4c8cc25fa8ea48b9178e92ec1bdab963696fbc8581dd15a0bb420ef528\"\n },\n \"hotkey\": {\n \"ss58\": \"5GP7c3fFazW9GXK8Up3qgu2DJBk8inu4aK9TZy3RuoSWVCMi\",\n \"hex\": \"0xbefb4b2b719c0dc08273b9293fa8166180fe3c0e6e0fc9f4cb224f429dc8163c\"\n },\n \"netuid\": 0,\n \"uid\": 61,\n \"block_number\": 4107535,\n \"timestamp\": \"2024-10-23T17:32:36.002Z\",\n \"active\": false,\n \"validator_permit\": true,\n \"is_immunity_period\": false,\n \"updated\": 12639,\n \"registered_block_number\": 1969422,\n \"rank\": 4,\n \"validator_trust\": \"0.32500190737773708705\",\n \"stake\": \"441767775908160\",\n \"emission\": \"0\",\n \"daily_reward\": \"0\",\n \"incentive\": \"0\",\n \"consensus\": \"0\",\n \"dividends\": \"0.0129701686121919585\",\n \"trust\": \"0\",\n \"axon_info\": null\n },\n {\n \"coldkey\": {\n \"ss58\": \"5GcCZ2BPXBjgG88tXJCEtkbdg2hNrPbL4EFfbiVRvBZdSQDC\",\n \"hex\": \"0xc8f623c92b47ac9645d6744f3d448cdb7a2a3b08a22a39bfd1db0afbd9c07117\"\n },\n \"hotkey\": {\n \"ss58\": \"5GKH9FPPnWSUoeeTJp19wVtd84XqFW4pyK2ijV2GsFbhTrP1\",\n \"hex\": \"0xbc0e6b701243978c1fe73d721c7b157943a713fca9f3c88cad7a9f7799bc6b26\"\n },\n \"netuid\": 0,\n \"uid\": 6,\n \"block_number\": 4107535,\n \"timestamp\": \"2024-10-23T17:32:36.002Z\",\n \"active\": false,\n \"validator_permit\": true,\n \"is_immunity_period\": false,\n \"updated\": 7418,\n \"registered_block_number\": 1404310,\n \"rank\": 2,\n \"validator_trust\": \"0.26196688792248416876\",\n \"stake\": \"811782441370812\",\n \"emission\": \"0\",\n \"daily_reward\": \"0\",\n \"incentive\": \"0.00152590218966964218\",\n \"consensus\": \"0.00114442664225223163\",\n \"dividends\": \"0.04058899824521248188\",\n \"trust\": \"0.12539864194705119402\",\n \"axon_info\": null\n }\n ]\n}" }}400 — Bad request
Section titled “400 — Bad request”404 — Validator metrics not found
Section titled “404 — Validator metrics not found”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.