Skip to content
TAO$188.36
BTC0.002929
MCap$2.22B
Vol$86.25M

API reference / Subnets

A subnet's hyperparameter changes, newest first

GET/api/v2/subnets/{netuid}/hyperparam-changes
Status
Stable
Auth
API key or OAuth access token
Scope
data:read
Rate limit
plan

Every extrinsic-driven change of the subnet's hyperparameters (SubtensorModule storage written inside an extrinsic; reverted extrinsics excluded), newest first: the item (Tempo, Kappa, MaxAllowedUids, ...), the value before (decoded; the storage default when the key did not exist, value_before_defaulted) and after, both raw, who made it (origin: sudo, owner or other, e.g. register_network seeding a new subnet) and the call (call, call_id). Burn and Difficulty are never listed: the runtime moves them itself on every registration and adjustment. History is available from block 8,283,785 down to meta.coverage.from_height, which moves back as older history is added. Keyset-paged by meta.page.next_cursor. Also the hyperparam_changes section of GET /subnets/{netuid}?include=hyperparam_changes. One life: the default is the subnet life live at to_height (else the current), from its first block (meta.generation, meta.life_start_height, meta.from_height the first height served); an explicit from_height is served as asked, across lives. While per-life series are not available yet: every life, with those members null. Errors are application/problem+json: INVALID_RANGE, INVALID_LIMIT, INVALID_CURSOR, UNKNOWN_PARAMETER, SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503).

Path parameters

netuidpath, required· integer · 0 to 65535

Subnet slot (0 = root).

Query parameters

from_heightquery· integer · 0 to 2147483647

Only changes at or above this block height (inclusive).

to_heightquery· integer · 0 to 2147483647

Only changes at or below this block height (inclusive).

limitquery· integer · default 100 · 1 to 1000

Page size, 1..1000 (default 100).

cursorquery· string · up to 200 characters

meta.page.next_cursor of the previous page, passed back unchanged with the same other parameters. It is opaque and bound to them: a cursor used with different parameters, or altered, is a 400 INVALID_CURSOR.

Response

data is a list of objects with these fields. Amounts are integer strings in their base unit, and null means unknown, never zero (see Units and formats). meta.at names the block the answer was read at.

Changes newest first by (height, seq); [] when there are none.

idstring · unit id

{height}-{seq}: the change's id (the extrinsic's last write to the key).

Format: block and index, such as 4200000-3
heightinteger · unit block

The block of the change.

timestring (date-time) · can be null

The block's time (RFC 3339 UTC).

Format: date and time, ISO 8601 in UTC
extrinsic_idstring · unit id · can be null

The extrinsic that made it, {height}-{index} (/api/v2/extrinsics/{id}). Null on a hook change, which no extrinsic makes.

Format: block and index, such as 4200000-3
itemstring

The SubtensorModule storage item written: the hyperparameter's storage name (Tempo, Kappa, MaxAllowedUids, ...). Burn and Difficulty are never listed: the runtime moves them itself on every registration and adjustment, so they are not owner or sudo changes.

value_beforevalue

The value before the change, decoded with the metadata in force at height (a number, boolean, string or object, as the item's type decodes); the item's storage default when the key did not exist (value_before_defaulted).

value_before_defaultedboolean

True when the key did not exist before: value_before is the item's storage default.

value_aftervalue

The value written, decoded as value_before. Null when removed.

removedboolean

True when the change removed the key (the item falls back to its default).

value_before_rawstring · unit id · can be null

value_before as stored, SCALE 0x hex. Null when the key did not exist.

Format: hex: 0x and hex digits
value_after_rawstring · unit id · can be null

value_after as stored, SCALE 0x hex. Null when removed.

Format: hex: 0x and hex digits
originstring · can be null

Who made the change: sudo (the AdminUtils call ran with a Root origin, Sudo.sudo), owner (a signed AdminUtils call: the subnet owner, the runtime refuses anyone else), other (no AdminUtils call in the extrinsic, e.g. register_network seeding a new subnet), hook (no extrinsic: the chain itself, at the end of a block: call dissolution_cleanup when a dissolved subnet's freed slot is reset, then network_registration when a queued registration sets the new subnet's initial parameters). Null when the extrinsic has no call row. Clients must accept values not documented yet. New values may be added; show an unknown value as is (or generically).

callstring · can be null

The Pallet.call that made the change: the extrinsic's innermost AdminUtils call, else its top-level call; dissolution_cleanup or network_registration for a hook change. Null with origin.

call_idstring · can be null

That call's id (/api/v2/calls/{id}). Null with call.

signerstring · can be null

The extrinsic's signer, SS58. Null for an unsigned extrinsic and on an older data version's answer.

Format: SS58 address
categoryenum · can be null

The parameter's family. Null on an older data version's answer. Clients must accept values not documented yet.

One of: consensus, weights, registration, emission, owner, network, other

Response headers

10 headers: ETag, Cache-Control, CDN-Cache-Control, X-BTAI-Stale, X-BTAI-Stale-As-Of, RateLimit-Policy, RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
ETag

Strong validator of this answer. Send it back as If-None-Match: an unchanged answer is a 304 Not Modified without a body. A settled answer's validator leaves the chain head out, so it stays valid as the head moves.

Cache-Control

One of three classes: settled public, max-age=3600, stale-while-revalidate=86400 (pinned to a block that cannot move), slow public, max-age=300, stale-while-revalidate=600 (state that moves in minutes or days) or tip public, max-age=6, stale-while-revalidate=12 (follows the chain head); the label routes are cached until the next nightly copy (public, max-age=<seconds>, stale-while-revalidate=60). Never immutable. no-store on an earlier answer served because the data source failed (X-BTAI-Stale).

CDN-Cache-Control

The same class for shared caches (RFC 9213; browsers ignore it): settled 24 h, slow 300 s, tip 6 s, each with stale-while-revalidate and stale-if-error; no-store with X-BTAI-Stale.

X-BTAI-Stale

Present only when the data source failed to answer (it timed out or was unavailable) and an earlier answer to the same request is served instead of a 503 (stale if error, RFC 5861). Then if-error, with X-BTAI-Stale-As-Of, Age (its seconds since then) and Warning: 110 - "Response is Stale", and Cache-Control: no-store: the answer is never kept as fresh, and a later request reads again. Prices and quotes are never served this way.

X-BTAI-Stale-As-Of

With X-BTAI-Stale: when the earlier answer served was produced, an RFC 3339 UTC time (2026-10-21T12:00:00Z).

RateLimit-Policy

The tier's request quota of the current window (IETF draft), e.g. "tier";q=600.

RateLimit

Requests left in the current window and the seconds until it resets (IETF draft), e.g. "tier";r=597;t=42.

X-RateLimit-Limit

The tier's request quota of the current window.

X-RateLimit-Remaining

Requests left in the current window.

X-RateLimit-Reset

When the current window resets, Unix seconds.

Status codes

200 · 304 · 400 · 401 · 402 · 403 · 404 · 429 · 500 · 502 · 503

304 Not Modified: the If-None-Match validator still matches; no body.

Error codes

The codes this endpoint can return. Each links to what it means and what to do.

From the API's published specification, version 1.165.0.