Documentation / API reference / OTC
OTC Subnet Freeze Status
Reference
Last reviewed 2026-09-18
Returns the OTC trading freeze status for each subnet. A frozen subnet has OTC trading suspended (typically during a protocol upgrade, emergency response, or operator decision). Each row records the block + actor that last changed the freeze flag and the stated reason.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | Subnet id. Omit to return all subnets. | |
frozen | query | string | Filter to currently-frozen (true) or currently-open (false) subnets. One of frozen, unfrozen, all. | |
page | query | integer (int32) | 1-based page number. | |
limit | query | integer (int32) | Page size (max 200). | |
order | query | string | Sort order, e.g. netuid_asc. One of netuid_asc, netuid_desc, timestamp_asc, timestamp_desc, block_number_asc, block_number_desc. |
Responses
200 — Subnet status retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].block_number | integer (int32) | Yes | |
data[].changed_by | object | Yes | |
data[].changed_by.hex | string | Yes | The hex format of the hot key |
data[].changed_by.ss58 | string | Yes | The SS58 format of the hot key |
data[].frozen | boolean | Yes | |
data[].netuid | integer (int32) | Yes | |
data[].reason | 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 |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.