Documentation / API reference / Subnet
Get Subnet Registrations
Last reviewed 2026-09-18
Returns subnet registration events with the owner, registering account and registration cost. Records include the subnet netuid, recycled amount, block number and timestamp.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | Subnet | |
owner | query | string | SS58 or hex format | |
registered_by | query | string | SS58 or hex format | |
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 | string (date-time) | Start of timestamp range (inclusive) | |
timestamp_end | query | string (date-time) | End of timestamp range (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, register_cost_asc, register_cost_desc. |
Responses
200 — Subnet registrations retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].block_number | integer (int32) | Yes | |
data[].netuid | integer (int32) | Yes | |
data[].owner | object, nullable | ||
data[].owner.hex | string | Yes | The hex format of the hot key |
data[].owner.ss58 | string | Yes | The SS58 format of the hot key |
data[].recycled_at_registration | string | Yes | |
data[].registered_by | object, nullable | ||
data[].registered_by.hex | string | Yes | The hex format of the hot key |
data[].registered_by.ss58 | string | Yes | The SS58 format of the hot key |
data[].registration_cost | string | Yes | |
data[].timestamp | string (date-time) | 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": 4084840,
"netuid": 47,
"owner": {
"hex": "0xf6d04b3b31e38b1bdb811ae945b9466b3e1924418b12aba664e30f888aa55e47",
"ss58": "5HeKWhzZ1KGJVMAdAweyDA9c2TZW6mNRXzSGuQdAQpmU1zbE"
},
"recycled_at_registration": "7665571436",
"registered_by": {
"hex": "0xf6d04b3b31e38b1bdb811ae945b9466b3e1924418b12aba664e30f888aa55e47",
"ss58": "5HeKWhzZ1KGJVMAdAweyDA9c2TZW6mNRXzSGuQdAQpmU1zbE"
},
"registration_cost": "2017009719904",
"timestamp": "2024-10-20T13:52:48Z"
},
{
"block_number": 4067835,
"netuid": 36,
"owner": {
"hex": "0x6ec82ce17c50c11c51791f9e64ff8c3b30f76b87b7ed9550ec884c0bf9bf1179",
"ss58": "5EZxb7YGiyMxD18Nv6hk9wi7NkhasgRMN1ssXSMqPcPFjauW"
},
"recycled_at_registration": "159810432782",
"registered_by": {
"hex": "0x6ec82ce17c50c11c51791f9e64ff8c3b30f76b87b7ed9550ec884c0bf9bf1179",
"ss58": "5EZxb7YGiyMxD18Nv6hk9wi7NkhasgRMN1ssXSMqPcPFjauW"
},
"registration_cost": "1430961435352",
"timestamp": "2024-10-18T05:06:48.001Z"
}
],
"pagination": {
"current_page": 1,
"next_page": 2,
"per_page": 5,
"prev_page": null,
"total_items": 128,
"total_pages": 26
}
}Response details
text
"block_number": 5453192,
"timestamp": "2025-04-28T21:52:00Z",
"netuid": 99,
"registration_cost": "252165013565", as rao
"recycled_at_registration": "0", as rao
"owner": {
"ss58": "5EFSqmNR49Yt6NLHc45ixSBUUtakjtT3ew3SwV3KiDWAvgzn",
"hex": "0x60a99e9403292f1812f038a1647959a7141685233ee061905c3591dc2e14f420"
},
"registered_by": {
"ss58": "5EFSqmNR49Yt6NLHc45ixSBUUtakjtT3ew3SwV3KiDWAvgzn",
"hex": "0x60a99e9403292f1812f038a1647959a7141685233ee061905c3591dc2e14f420"
}Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Subnet registrations not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.