Documentation / API reference / Metagraph
Get Root Subnet Metagraph
Reference
Last reviewed 2026-09-18
Returns the latest Root Metagraph, 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 | |
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 uid_asc, uid_desc, stake_asc, stake_desc. |
Responses
200 — Metagraph 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": 4106827,
"coldkey": {
"hex": "0xe2a8d08674697d6ee2ccec36f0e207653788275b619392256e509be04d32950d",
"ss58": "5HBtpwxuGNL1gwzwomwR7sjwUt8WXYSuWcLYN6f9KpTZkP4k"
},
"consensus": "0.1671778439002059968",
"hotkey": {
"hex": "0x84d83d08ca89f8e60424ffa286f165c16dd8752e4faa4d8977221e6720678d28",
"ss58": "5F4tQyWrhfGVcNhoqeiNsR6KjD4wMZ2kfhLj4oHYuyHbZAc3"
},
"pruning_score": "0.23477531090257114519",
"rank": "0.13191424429694056611",
"senator": true,
"stake": "876353769028828",
"subnet_weights": {
"0": "29.2280",
"1": "2.9703",
"2": "0",
"3": "0",
"4": "4.9505",
"5": "1.9802",
"6": "0.9602",
"7": "0",
"8": "2.8811",
"9": "8.6536",
"10": "0",
"11": "1.9802",
"12": "0.9901",
"13": "2.8811",
"14": "0",
"15": "0",
"16": "0.4950",
"17": "1.7327",
"18": "0",
"19": "8.6536",
"20": "0.7426",
"21": "2.9703",
"22": "0",
"23": "0",
"24": "0.9901",
"25": "0.9901",
"26": "0.9901",
"27": "0.4950",
"28": "0",
"29": "5.9406",
"30": "0",
"31": "1.9802",
"32": "2.9703",
"33": "0",
"34": "1.4851",
"35": "0",
"36": "0",
"37": "2.9703",
"38": "0",
"39": "0.7426",
"40": "1.4455",
"41": "0",
"42": "0",
"43": "1.4851",
"44": "0",
"45": "0.9901",
"46": "0.9901",
"47": "0",
"48": "0.9901",
"49": "0.4950",
"50": "0",
"51": "1.9802",
"52": "0"
},
"timestamp": "2024-10-23T15:11:00Z",
"uid": 2
},
{
"block_number": 4106827,
"coldkey": {
"hex": "0xc8f623c92b47ac9645d6744f3d448cdb7a2a3b08a22a39bfd1db0afbd9c07117",
"ss58": "5GcCZ2BPXBjgG88tXJCEtkbdg2hNrPbL4EFfbiVRvBZdSQDC"
},
"consensus": "0.00114442664225223163",
"hotkey": {
"hex": "0xbc0e6b701243978c1fe73d721c7b157943a713fca9f3c88cad7a9f7799bc6b26",
"ss58": "5GKH9FPPnWSUoeeTJp19wVtd84XqFW4pyK2ijV2GsFbhTrP1"
},
"pruning_score": "0.13810940718699931334",
"rank": "0.00152590218966964218",
"senator": true,
"stake": "811732115178311",
"subnet_weights": {
"0": "0",
"1": "4.0486",
"2": "0",
"3": "0.3037",
"4": "1.0121",
"5": "0",
"6": "1.0121",
"7": "1.0121",
"8": "1.0121",
"9": "5.0607",
"10": "1.4171",
"11": "3.2389",
"12": "0.6072",
"13": "4.2511",
"14": "0",
"15": "0.8097",
"16": "0",
"17": "4.0486",
"18": "6.0729",
"19": "15.1822",
"20": "0.4050",
"21": "0.4050",
"22": "0",
"23": "5.0607",
"24": "0",
"25": "4.0486",
"26": "0.4050",
"27": "1.6193",
"28": "1.4171",
"29": "4.2511",
"30": "0.4050",
"31": "2.6315",
"32": "2.6315",
"33": "2.6315",
"34": "2.8340",
"35": "0.8097",
"36": "0.3037",
"37": "1.0121",
"38": "1.6193",
"39": "1.6193",
"40": "0",
"41": "4.0486",
"42": "1.4171",
"43": "2.2268",
"44": "4.0486",
"45": "0.8097",
"46": "0",
"47": "0",
"48": "0.6072",
"49": "0",
"50": "0",
"51": "2.0243",
"52": "1.6193"
},
"timestamp": "2024-10-23T15:11:00Z",
"uid": 6
}
],
"pagination": {
"current_page": 1,
"next_page": 2,
"per_page": 25,
"prev_page": null,
"total_items": 64,
"total_pages": 3
}
}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 not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.