Documentation / API reference / Subnet
Get Subnet Pruning Latest
Reference
Last reviewed 2026-09-18
Returns the latest subnet pruning ranks, moving prices and immunity status. These records describe subnet deregistration risk, not individual neuron pruning. They include the registration block and remaining immunity blocks.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | ||
is_immune | query | boolean | ||
page | query | integer (int32) | ||
limit | query | integer (int32) | ||
order | query | string | One of pruning_rank_asc, pruning_rank_desc, netuid_asc, netuid_desc, registered_at_block_asc, registered_at_block_desc, immunity_blocks_remaining_asc, immunity_blocks_remaining_desc, is_immune_asc, is_immune_desc, moving_price_asc, moving_price_desc. |
Responses
200 — Subnets retrieved successfully
| Field | Type | Required |
|---|---|---|
data | array | Yes |
data[].block_number | integer (int32) | Yes |
data[].immunity_blocks_remaining | integer (int32) | Yes |
data[].is_immune | boolean | Yes |
data[].moving_price | string | Yes |
data[].netuid | integer (int32) | Yes |
data[].pruning_rank | integer (int32) | Yes |
data[].registered_at_block | integer (int32) | 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 |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Subnets not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.