Get Validator Metrics

Endpoint

GET /api/validator/metrics/latest/v1

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

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

404 — Validator metrics not found

500 — Internal server error

Try it

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

Authentication

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