Documentation / API reference / Neuron
Get Neuron Incentive Distribution
Reference
Last reviewed 2026-09-18
Returns neuron incentives and immunity status for a subnet, with each neuron's UID, hotkey and coldkey. Use these records to inspect how incentives are distributed among neurons.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | Yes | Subnet ID |
days | query | integer (int32) | Yes | Integer between 1 and 7 |
Responses
200 — Neuron history 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[].incentive | string | Yes | |
data[].is_immune | boolean | Yes | |
data[].registration_block | integer (int32) | 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 |
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.