Documentation / API reference / Metagraph
Get Root Subnet History
Reference
Last reviewed 2026-09-18
Returns historical Root Metagraph snapshots, including neuron stake, consensus and subnet weights. Records identify each Root neuron by UID, hotkey and coldkey.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
hotkey | query | string | SS58 or hex format | |
block_start | query | integer (int32) | Start of block range (inclusive) | |
block_end | query | integer (int32) | End of block range (inclusive) | |
timestamp_start | query | integer (int64) | Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | |
timestamp_end | query | integer (int64) | End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | |
page | query | integer (int32) | The page number of the response. | |
limit | query | integer (int32) | The number of responses. max is 200, | |
order | query | string | One of block_number_asc, block_number_desc, timestamp_asc, timestamp_desc. |
Responses
200 — Metagraph history retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].block_number | integer (int32) | Yes | |
data[].coldkey | object | Yes | |
data[].coldkey.hex | string | Yes | The hex format of the hot key |
data[].coldkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].consensus | string | 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[].pruning_score | string | Yes | |
data[].rank | string | Yes | |
data[].senator | boolean | Yes | |
data[].stake | string | Yes | |
data[].subnet_weights | object | Yes | |
data[].timestamp | string (date-time) | Yes | |
data[].uid | integer (int32) | 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 |
Example response
json
{
"data": [
{
"block_number": 4336135,
"coldkey": {
"hex": "0x0c9c8ec969246de9771893dd7e89e5e70483e860c45359b3223cd01d598f0c7d",
"ss58": "5CMEwRYLefRmtJg7zzRyJtcXrQqmspr9B1r1nKySDReA37Z1"
},
"consensus": "0.00738536659800106813",
"hotkey": {
"hex": "0x82cca2238d379e49d84e9e1b8df35dd496d6a8b4ca4f511ac9e38fa04d42f86b",
"ss58": "5F2CsUDVbRbVMXTh9fAzF9GacjVX7UapvRxidrxe7z8BYckQ"
},
"pruning_score": "0.02160677500572213321",
"rank": "0.00901808194094758526",
"senator": false,
"stake": "84170506936415",
"subnet_weights": {
"0": "0",
"1": "3.0000",
"2": "2.0000",
"3": "0",
"4": "4.0000",
"5": "3.0000",
"6": "2.0000",
"7": "3.0000",
"8": "3.0000",
"9": "1.0000",
"10": "3.0000",
"11": "2.0000",
"12": "3.0000",
"13": "2.0000",
"14": "2.0000",
"15": "1.0000",
"16": "2.0000",
"17": "3.0000",
"18": "3.0000",
"19": "3.0000",
"20": "5.0000",
"21": "1.0000",
"22": "1.0000",
"23": "3.0000",
"24": "3.0000",
"25": "2.0000",
"26": "2.0000",
"27": "3.0000",
"28": "3.0000",
"29": "1.0000",
"30": "2.0000",
"31": "2.0000",
"32": "3.0000",
"33": "2.0000",
"34": "1.0000",
"35": "1.0000",
"36": "1.0000",
"37": "1.0000",
"38": "1.0000",
"39": "1.0000",
"40": "1.0000",
"41": "1.0000",
"42": "0",
"43": "1.0000",
"44": "1.0000",
"45": "4.0000",
"46": "1.0000",
"47": "1.0000",
"48": "1.0000",
"49": "1.0000",
"50": "1.0000",
"51": "1.0000",
"52": "1.0000",
"53": "1.0000",
"54": "0",
"55": "0",
"56": "0"
},
"timestamp": "2024-11-24T14:11:24Z",
"uid": 5
},
{
"block_number": 4336135,
"coldkey": {
"hex": "0x04c04d0aab0229a3e43fb5b00680932d53dee07d2756519fd72b2a81e6759163",
"ss58": "5CAwB3dSiMC5jJfpvVU47zT3Gyz5ZDoiyHMaYZUuNs5hFh2P"
},
"consensus": "0.09689478904402227817",
"hotkey": {
"hex": "0xe824c935940357af73c961bdd7387e1ab821ec2939ecd19daafe6081ae9ae674",
"ss58": "5HK5tp6t2S59DywmHRWPBVJeJ86T61KjurYqeooqj8sREpeN"
},
"pruning_score": "0.3438315403982604715",
"rank": "0.14354161898222323949",
"senator": true,
"stake": "299543519846094",
"subnet_weights": {
"0": "0",
"1": "5.0000",
"2": "0.5000",
"3": "0",
"4": "5.0000",
"5": "0.5000",
"6": "2.0000",
"7": "1.0000",
"8": "2.0000",
"9": "5.0000",
"10": "1.5000",
"11": "4.0000",
"12": "3.5000",
"13": "5.0000",
"14": "0",
"15": "0",
"16": "0.5000",
"17": "2.0000",
"18": "2.0000",
"19": "5.0000",
"20": "3.0000",
"21": "5.5000",
"22": "0",
"23": "1.0000",
"24": "5.5000",
"25": "5.0000",
"26": "1.0000",
"27": "1.0000",
"28": "0.5000",
"29": "2.0000",
"30": "1.0000",
"31": "2.0000",
"32": "2.0000",
"33": "5.0000",
"34": "2.0000",
"35": "1.0000",
"36": "2.0000",
"37": "2.0000",
"38": "0",
"39": "3.0000",
"40": "1.0000",
"41": "1.0000",
"42": "0",
"43": "2.0000",
"44": "1.0000",
"45": "3.0000",
"46": "0",
"47": "1.0000",
"48": "0",
"49": "0",
"50": "0",
"51": "1.0000",
"52": "1.0000",
"53": "0",
"54": "0",
"55": "0",
"56": "0"
},
"timestamp": "2024-11-24T14:11:24Z",
"uid": 4
}
],
"pagination": {
"current_page": 1,
"next_page": 2,
"per_page": 64,
"prev_page": null,
"total_items": 26741,
"total_pages": 418
}
}Response details
text
{
"hotkey": {
"ss58": "5FcXnzNo3mrqReTEY4ftkg5iXRBi61iyvM4W1bywZLRqfxAY",
"hex": "0x9cfaad41f06ee5e2219c74c57e1107ea113f2e09ce355522b291cbceb222df69"
},
"coldkey": {
"ss58": "5HeQuPVRSZVE3LWdKx9q6upyCi53TjQ4a2S8mnJ5emyWFf5b",
"hex": "0xf6e27117cf7563a38148658fecdea207fad57139698cfcd66b47b25b19d24917"
},
"uid": 43,
"block_number": 5453684,
"timestamp": "2025-04-28T23:30:24Z",
"stake": "0",
"consensus": "0.00459296559090562295",
"senator": false,
"rank": "0.00576791027695124743",
"pruning_score": "0.01383993286030365454",
"subnet_weights": { no longer used
"0": "0",
"1": "0",
"2": "0.0000",
"3": "0.0000",
"4": "16.6667",
"5": "16.6667",
"6": "0",
"7": "0.0000",
"8": "16.6667",
"9": "16.6667",
"10": "0.0000",
"11": "0",
"12": "0",
"13": "0",
"14": "0",
"15": "0",
"16": "0",
"17": "0",
"18": "16.6667",
"19": "0",
"20": "0",
"21": "0",
"22": "0",
"23": "0",
"24": "0",
"25": "0",
"26": "0",
"27": "16.6667",
"28": "0",
"29": "0",
"30": "0",
"31": "0",
"32": "0",
"33": "0",
"34": "0",
"35": "0",
"36": "0",
"37": "0",
"38": "0",
"39": "0",
"40": "0",
"41": "0",
"42": "0",
"43": "0",
"44": "0",
"45": "0",
"46": "0",
"47": "0",
"48": "0",
"49": "0",
"50": "0",
"51": "0",
"52": "0",
"53": "0",
"54": "0",
"55": "0",
"56": "0",
"57": "0",
"58": "0",
"59": "0",
"60": "0",
"61": "0",
"62": "0",
"63": "0",
"64": "0",
"65": "0",
"66": "0",
"67": "0",
"68": "0",
"69": "0",
"70": "0",
"71": "0",
"72": "0",
"73": "0",
"74": "0",
"75": "0",
"76": "0",
"77": "0",
"78": "0",
"79": "0",
"80": "0",
"81": "0",
"82": "0",
"83": "0",
"84": "0",
"85": "0",
"86": "0",
"87": "0",
"88": "0",
"89": "0",
"90": "0",
"91": "0",
"92": "0",
"93": "0",
"94": "0",
"95": "0",
"96": "0",
"97": "0",
"98": "0",
"99": "0"
}
},Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Metagraph history not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.