Documentation / API reference / Neuron
Get Neuron History
Reference
Last reviewed 2026-09-18
Returns historical neuron metrics, including incentives, stake weight, pruning scores, ranks and immunity status. Records identify neurons by subnet, UID, hotkey and coldkey.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | Subnet ID | |
uid | query | integer (int32) | Neuron ID | |
hotkey | query | string | SS58 or hex format | |
coldkey | query | string | SS58 or hex format | |
is_immune | query | boolean | Start of block range (inclusive) Is immune | |
in_danger | query | boolean | Is in danger | |
has_dividends | query | boolean | Has dividends | |
has_incentive | query | boolean | Has incentive | |
block_start | query | integer (int32) | ||
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) | ||
limit | query | integer (int32) | ||
order | query | string | One of block_number_asc, block_number_desc, timestamp_asc, timestamp_desc. |
Responses
200 — Neuron history retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].active | boolean | Yes | |
data[].axon | string, nullable | ||
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[].dividends | string | Yes | |
data[].emission | 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[].in_danger | boolean | Yes | |
data[].incentive | string | Yes | |
data[].is_immune | boolean | Yes | |
data[].mech_incentive | array | Yes | |
data[].mech_incentive[] | string | Yes | |
data[].miner_rank | integer (int32), nullable | ||
data[].name | string, nullable | ||
data[].netuid | integer (int32) | Yes | |
data[].pruning_score | string | Yes | |
data[].registration_block | integer (int32) | Yes | |
data[].stake_weight | string, nullable | ||
data[].timestamp | string (date-time) | Yes | |
data[].trust | string | Yes | |
data[].uid | integer (int32) | Yes | |
data[].validator_permit | boolean | Yes | |
data[].validator_rank | integer (int32), nullable | ||
data[].validator_trust | 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 |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Neuron history not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.