Documentation / API reference / Subnet
Get Neuron Registrations
Last reviewed 2026-09-18
Returns neuron registration records with the subnet, UID, hotkey, coldkey and registration cost. Filter by participant or block and time ranges.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | Subnet | |
uid | query | integer (int32) | Neuron ID | |
hotkey | query | string | SS58 or hex format | |
coldkey | 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 | 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, registration_cost_asc, registration_cost_desc. |
Responses
200 — Subnet neuron registrations 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[].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 | |
data[].registration_cost | string | 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": 4104101,
"coldkey": {
"hex": "0xa6862f1f35e4b636deb0cc9151c65305556cbc6f15ae046aa77e1999d666eb77",
"ss58": "5Fq3fe6XGeAoxV5tsRApee1YEvnKgBdxxvY6wHEPAvibsguY"
},
"hotkey": {
"hex": "0x1af5fef0b561f372ed9c169623760312f048711359782e16a754835a8bd3174b",
"ss58": "5Cg4BHi4yvZWA6YPKgU48za4dpiiApSEoTsFuzmsYKRAzkpa"
},
"netuid": 19,
"registration_cost": "277988201",
"timestamp": "2024-10-23T06:05:36.001Z",
"uid": 251
},
{
"block_number": 4104100,
"coldkey": {
"hex": "0xa6862f1f35e4b636deb0cc9151c65305556cbc6f15ae046aa77e1999d666eb77",
"ss58": "5Fq3fe6XGeAoxV5tsRApee1YEvnKgBdxxvY6wHEPAvibsguY"
},
"hotkey": {
"hex": "0x4e1d27e2eaf252e681eedc2518dd97a24a560e400ddfcf1e441a5afd57020659",
"ss58": "5Dq8FeBwuRaANWuroMdzeBX6bmV17Fw77TBP8v3nodQjLT19"
},
"netuid": 19,
"registration_cost": "277988201",
"timestamp": "2024-10-23T06:05:24Z",
"uid": 5
}
],
"pagination": {
"current_page": 1,
"next_page": 2,
"per_page": 10,
"prev_page": null,
"total_items": 6794,
"total_pages": 680
}
}Response details
text
{
"block_number": 5453693,
"timestamp": "2025-04-28T23:32:12Z",
"netuid": 79,
"uid": 111,
"hotkey": {
"ss58": "5EjX1AGvv1vHcmYW7QiC74dYLkZpbDK4CQYXMFw69AtvrQY2",
"hex": "0x76128051af6183acf2d1cac97a24a738d16809cea1515700bc50aba111786c48"
},
"coldkey": {
"ss58": "5FxuS6WovEd2oEKHReSJ7VuLkquDkWrcPXSDWDc4qdHRU2FA",
"hex": "0xac846e47fbf44e7601cbaf23d8aafe590325fe31d92ead77bf2d437210374656"
},
"registration_cost": "1675800" as rao
},Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Subnet neuron registrations not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.