Documentation / API reference / Hotkey
Get Parent/Child Hotkey History
Reference
Last reviewed 2026-09-18
Returns historical parent and child hotkey relationships and family stake totals within subnets. Records include Root and Alpha stake, delegation proportions and take values.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
hotkey | query | string | SS58 or hex formatted public key | |
netuid | query | integer (int32) | Subnet ID | |
block_number | query | integer (int32) | The exact block number | |
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, netuid_asc, netuid_desc. |
Responses
200 — Hotkey family history retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].alpha_stake | string | Yes | |
data[].block_number | integer (int32) | Yes | |
data[].childkey_take | string | Yes | |
data[].children | array | Yes | |
data[].children[].alpha_stake | string | Yes | |
data[].children[].childkey_take | string | Yes | |
data[].children[].coldkey | object | Yes | |
data[].children[].coldkey.hex | string | Yes | The hex format of the hot key |
data[].children[].coldkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].children[].family_alpha_stake | string | Yes | |
data[].children[].family_root_stake | string | Yes | |
data[].children[].family_root_stake_as_alpha | string | Yes | |
data[].children[].family_stake | string | Yes | Total stake including parent/child relationships |
data[].children[].family_total_alpha_stake | string | Yes | |
data[].children[].hotkey | object | Yes | |
data[].children[].hotkey.hex | string | Yes | The hex format of the hot key |
data[].children[].hotkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].children[].proportion | string | Yes | The proportion of the stake given to the child |
data[].children[].proportion_alpha_stake | string | Yes | |
data[].children[].proportion_root_stake | string | Yes | |
data[].children[].proportion_root_stake_as_alpha | string | Yes | |
data[].children[].proportion_staked | string | Yes | The stake given to the child |
data[].children[].proportion_total_alpha_stake | string | Yes | |
data[].children[].root_stake | string | Yes | |
data[].children[].root_stake_as_alpha | string | Yes | |
data[].children[].root_weight | string | Yes | |
data[].children[].stake | string | Yes | Total stake excluding parent/child relationships |
data[].children[].take | string | Yes | |
data[].children[].total_alpha_stake | string | 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[].family_alpha_stake | string | Yes | |
data[].family_root_stake | string | Yes | |
data[].family_root_stake_as_alpha | string | Yes | |
data[].family_stake | string | Yes | Total stake including parent/child relationships |
data[].family_total_alpha_stake | 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[].netuid | integer (int32) | Yes | The subnet ID |
data[].parents | array | Yes | |
data[].parents[].alpha_stake | string | Yes | |
data[].parents[].childkey_take | string | Yes | |
data[].parents[].coldkey | object | Yes | |
data[].parents[].coldkey.hex | string | Yes | The hex format of the hot key |
data[].parents[].coldkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].parents[].family_alpha_stake | string | Yes | |
data[].parents[].family_root_stake | string | Yes | |
data[].parents[].family_root_stake_as_alpha | string | Yes | |
data[].parents[].family_stake | string | Yes | Total stake including parent/child relationships |
data[].parents[].family_total_alpha_stake | string | Yes | |
data[].parents[].hotkey | object | Yes | |
data[].parents[].hotkey.hex | string | Yes | The hex format of the hot key |
data[].parents[].hotkey.ss58 | string | Yes | The SS58 format of the hot key |
data[].parents[].proportion | string | Yes | The proportion of the stake given to the child |
data[].parents[].proportion_alpha_stake | string | Yes | |
data[].parents[].proportion_root_stake | string | Yes | |
data[].parents[].proportion_root_stake_as_alpha | string | Yes | |
data[].parents[].proportion_staked | string | Yes | The stake given to the child |
data[].parents[].proportion_total_alpha_stake | string | Yes | |
data[].parents[].root_stake | string | Yes | |
data[].parents[].root_stake_as_alpha | string | Yes | |
data[].parents[].root_weight | string | Yes | |
data[].parents[].stake | string | Yes | Total stake excluding parent/child relationships |
data[].parents[].take | string | Yes | |
data[].parents[].total_alpha_stake | string | Yes | |
data[].root_stake | string | Yes | |
data[].root_stake_as_alpha | string | Yes | |
data[].root_weight | string | Yes | |
data[].stake | string | Yes | Total stake excluding parent/child relationships |
data[].take | string | Yes | |
data[].timestamp | string (date-time) | Yes | |
data[].total_alpha_stake | string | 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": [
{
"active": false,
"axon_info": null,
"block_number": 4107528,
"coldkey": {
"hex": "0xc8c348f4594ec3ff5ecd1dddb5bdea346c6139c01e525b65c1b1437a40f4061d",
"ss58": "5GbwSp7m4AF1hYpoXtkwaveDjuNHifHJbktfW2UkQfVVenLg"
},
"consensus": "0.1816281376363775082",
"daily_reward": "9057987420",
"dividends": "0",
"emission": "452899371",
"hotkey": {
"hex": "0x84b58d8a47c3f75b38416776042702e6f7b4bdecd102df0cf2ef686d4ac5ce67",
"ss58": "5F4i7Mh2FtxyP4cKMkQ4cExRZL6JuJ5t3JMgsybqFF8z9VrH"
},
"incentive": "0.21431296253910124361",
"is_immunity_period": false,
"netuid": 21,
"rank": 0,
"registered_block_number": 3963260,
"stake": "0",
"timestamp": "2024-10-23T17:31:12.010Z",
"trust": "0.89900053406576638437",
"uid": 88,
"updated": 707588,
"validator_permit": false,
"validator_trust": "0"
},
{
"active": false,
"axon_info": {
"block": 3868571,
"ip": "54.189.14.49",
"ipType": 4,
"placeholder1": 0,
"placeholder2": 0,
"port": 8905,
"protocol": 4,
"version": 712
},
"block_number": 4107528,
"coldkey": {
"hex": "0x34c5005b9afc66842f9c5d268ebc858ad7ceda368240f482125f698811377960",
"ss58": "5DFtsLukQEb3jB4TRC74FtAkQiRPBjcNoe8j6Kp1S792qNzX"
},
"consensus": "0.00088502327000839246",
"daily_reward": "111829018.18181818181818181818",
"dividends": "0",
"emission": "1537649",
"hotkey": {
"hex": "0xe83f9f9c942710a844087cd44c86e5a073d155ab827775cf8089f2c58fdbcc19",
"ss58": "5HKDsDGrjqGUaJBtD8Chrkxj3FU4p2pd1Wzj7Asoibogi5dc"
},
"incentive": "0.00091554131380178531",
"is_immunity_period": true,
"netuid": 1,
"rank": 572,
"registered_block_number": 4101001,
"stake": "155764371",
"timestamp": "2024-10-23T17:31:12.010Z",
"trust": "0.90577553978789959564",
"uid": 405,
"updated": 1564760,
"validator_permit": false,
"validator_trust": "0"
}
],
"pagination": {
"current_page": 1,
"next_page": 2,
"per_page": 50,
"prev_page": null,
"total_items": 5020104,
"total_pages": 100403
}
}Response details
text
{
"hotkey": {
"ss58": "5F2CsUDVbRbVMXTh9fAzF9GacjVX7UapvRxidrxe7z8BYckQ",
"hex": "0x82cca2238d379e49d84e9e1b8df35dd496d6a8b4ca4f511ac9e38fa04d42f86b"
},
"coldkey": {
"ss58": "5CMEwRYLefRmtJg7zzRyJtcXrQqmspr9B1r1nKySDReA37Z1",
"hex": "0x0c9c8ec969246de9771893dd7e89e5e70483e860c45359b3223cd01d598f0c7d"
},
"block_number": 5454180,
"timestamp": "2025-04-29T01:09:36Z",
"netuid": 1,
"stake": "0",
"family_stake": "0",
"take": "0.08999771114671549554",
"childkey_take": "0.08999771114671549554",
"children": [],
"parents": [
{
"hotkey": {
"ss58": "5FFM6Nvvm78GqyMratgXXvjbqZPi7SHgSQ81nyS96jBuUWgt",
"hex": "0x8cd280d43e4cf6501ae3b425583975ff63ce4d7470cf518074b5903ff375600e"
},
"coldkey": {
"ss58": "5GyAMYSxde6x5hG8AHksoPHZZeum8GXk8sXisgADNn6CSi7Y",
"hex": "0xd8f2e4fd7f807350f5188664c1831fa3d6872af51fdb660876af0eeea7a9aa55"
},
"stake": "0",
"family_stake": "0",
"take": "0.17999542229343099107",
"childkey_take": "0",
"proportion": "1",
"proportion_staked": "0",
"root_weight": "0.17999999999999999996",
"root_stake": "34905835585091",
"alpha_stake": "56454414461",
"root_stake_as_alpha": "6283050405316.3799986037665766",
"total_alpha_stake": "6339504819777.3799986037665766",
"family_root_stake": "0",
"family_alpha_stake": "0",
"family_root_stake_as_alpha": "0.37999860376657659636",
"family_total_alpha_stake": "0.37999860376657659636",
"proportion_root_stake": "34905835585091",
"proportion_alpha_stake": "56454414461",
"proportion_root_stake_as_alpha": "6283050405316",
"proportion_total_alpha_stake": "6339504819777"
},
{
"hotkey": {
"ss58": "5F27Eqz2PhyMtGMEce898x31DokNqRVxkm5AhDDe6rDGNvoY",
"hex": "0x82b9ad19799ddb1bf0c237ee5f0c4726d5c2ad27d71d2c276ee20d31b5391c37"
},
"coldkey": {
"ss58": "5GYXZBZoFA74nzAGg4R9omd2SfCDHiGufETtrLso6BRzv2p4",
"hex": "0xc6292094723749e68a8a8adbb40029a94e18e704c44b9f2400d50f6f3d496f7b"
},
"stake": "0",
"family_stake": "0",
"take": "0.17999542229343099107",
"childkey_take": "0",
"proportion": "1",
"proportion_staked": "0",
"root_weight": "0.17999999999999999996",
"root_stake": "29004429387691",
"alpha_stake": "123211789161",
"root_stake_as_alpha": "5220797289784.3799988398228245",
"total_alpha_stake": "5344009078945.3799988398228245",
"family_root_stake": "0",
"family_alpha_stake": "0",
"family_root_stake_as_alpha": "0.37999883982282449236",
"family_total_alpha_stake": "0.37999883982282449236",
"proportion_root_stake": "29004429387691",
"proportion_alpha_stake": "123211789161",
"proportion_root_stake_as_alpha": "5220797289784",
"proportion_total_alpha_stake": "5344009078945"
},
{
"hotkey": {
"ss58": "5H66JLTYFWaHDtBtScE4X9f5WDjrBS1iGeXeRykPuH3SMyNh",
"hex": "0xde3bf6047f6ee3cf426eded6fc9defe563c4d3429b5fdb6cda4127d24cf7742c"
},
"coldkey": {
"ss58": "5C8JS6BJ2SqbwxvxtmZ9HWQ6wqPSNpxoKYpVS87bCnD4rcWk",
"hex": "0x02be21535cb9b0b3a3e86c9cdb923cf87ef18caed5a754db42d9ca49e5e12729"
},
"stake": "0",
"family_stake": "0",
"take": "0.17999542229343099107",
"childkey_take": "0",
"proportion": "1",
"proportion_staked": "0",
"root_weight": "0.17999999999999999996",
"root_stake": "717552",
"alpha_stake": "91191378794",
"root_stake_as_alpha": "129159.35999999999997129792",
"total_alpha_stake": "91191507953.35999999999997130",
"family_root_stake": "0",
"family_alpha_stake": "0",
"family_root_stake_as_alpha": "0.35999999999997129792",
"family_total_alpha_stake": "0.35999999999997129792",
"proportion_root_stake": "717552",
"proportion_alpha_stake": "91191378794",
"proportion_root_stake_as_alpha": "129159",
"proportion_total_alpha_stake": "91191507953"
}
],
"root_weight": "0.17999999999999999996",
"root_stake": "162117222637484",
"alpha_stake": "15770304489972",
"root_stake_as_alpha": "29181100074747.119993515311094",
"total_alpha_stake": "44951404564719.119993515311094",
"family_root_stake": "226027488327818",
"family_alpha_stake": "16041162072388",
"family_root_stake_as_alpha": "40684947899006.119993515311094",
"family_total_alpha_stake": "56726109971394.119993515311094"
},Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Hotkey not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.