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

API reference / Network

The runtime's live staking parameters: take bounds, TaoWeight, CKBurn, minimum stake, swap fees

GET/api/v2/network/parameters
Status
Beta
Auth
API key or OAuth access token
Scope
data:read
Rate limit
plan

The runtime's staking parameters at the state head, each {value, basis, raw}: basis says whether the value is stored, the runtime's declared default (nothing stored) or a runtime_constant (not in storage); raw is the integer it comes from.

Full description

The runtime's staking parameters at the state head, each {value, basis, raw}: basis says whether the value is stored, the runtime's declared default (nothing stored) or a runtime_constant (not in storage); raw is the integer it comes from. The delegate and childkey take bounds (u16 / 65535; min at most max, checked), TaoWeight and CKBurn (u64 / u64::MAX; CKBurn is the part of a childkey's take recycled, only when the parent's and the child's owners differ), the minimum stake (2,000,000 rao) and RootStakeUnlockInterval; and every live subnet (by netuid) with its swap fee (Swap.FeeRate / 65535) and its effective childkey take floor. meta.spec_version is the runtime executing at the head. Also plain values with the unit in the name, each member's basis in meta.basis (stored / default): subnet_limit (SubnetLimit), subnets_including_root (the live netuids), num_staking_coldkeys (NumStakingColdkeys), supply (TotalStake, TotalIssuance, BlockEmission), the lock costs (NetworkLastLockCost, NetworkMinLockCost), network_rate_limit_blocks (NetworkRateLimit), the owner cut (SubnetOwnerCut as a ratio and its u16) and nominator_min_required_stake_tao_rao (NominatorMinRequiredStake); null on an older answer. stake_threshold_tao_rao (StakeThreshold, the validator-permit stake floor) and its stake_threshold_basis come from a chain-state read after the parameters: meta.state_read says where, or why they are null (not_ready: not deployed on this data source yet; source_unavailable). Live values, never genesis defaults unless nothing is stored. Cached as slow (governance moves them rarely). Errors are application/problem+json: UNKNOWN_PARAMETER, SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503).

Beta: this route may change with one release's notice in the v2 changelog; additive changes need none (x-stability: beta).

Query parameters

includequery· string

Reserved for opt-in sections. This route defines none yet; the parameter is declared so that adding one later is additive for generated clients. Any value is a 400 INVALID_INCLUDE.

Response

data is an object 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.

The parameters, each with its basis.

delegate_takeobject

MinDelegateTake / MaxDelegateTake (u16 / 65535).

2 fields in delegate_take
min_ratioobject

The lowest take a hotkey may set (at most max_ratio).

3 fields in min_ratio
valuestring · unit ratio · 12 decimals · can be null

The value: the raw integer over its type's maximum, 12 decimals, 0..1 (checked). Null when neither stored nor declared.

Format: decimal number, as a string
basisstring · can be null

stored (a value in storage), default (none stored: the runtime's declared default) or runtime_constant (not in storage at all, e.g. the minimum stake). Null exactly with value. New values may be added; show an unknown value as is (or generically).

rawstring · unit count · can be null

The stored or default integer (a u16 take over 65535, a u64 weight over u64::MAX, ...), as a decimal string; value is derived from it (checked). Null without one.

Format: whole number, as a string
max_ratioobject

The highest take a hotkey may set.

3 fields in max_ratio
valuestring · unit ratio · 12 decimals · can be null

The value: the raw integer over its type's maximum, 12 decimals, 0..1 (checked). Null when neither stored nor declared.

Format: decimal number, as a string
basisstring · can be null

stored (a value in storage), default (none stored: the runtime's declared default) or runtime_constant (not in storage at all, e.g. the minimum stake). Null exactly with value. New values may be added; show an unknown value as is (or generically).

rawstring · unit count · can be null

The stored or default integer (a u16 take over 65535, a u64 weight over u64::MAX, ...), as a decimal string; value is derived from it (checked). Null without one.

Format: whole number, as a string
childkey_takeobject

MinChildkeyTake / MaxChildkeyTake (u16 / 65535).

2 fields in childkey_take
min_ratioobject

The lowest take a hotkey may set (at most max_ratio).

3 fields in min_ratio
valuestring · unit ratio · 12 decimals · can be null

The value: the raw integer over its type's maximum, 12 decimals, 0..1 (checked). Null when neither stored nor declared.

Format: decimal number, as a string
basisstring · can be null

stored (a value in storage), default (none stored: the runtime's declared default) or runtime_constant (not in storage at all, e.g. the minimum stake). Null exactly with value. New values may be added; show an unknown value as is (or generically).

rawstring · unit count · can be null

The stored or default integer (a u16 take over 65535, a u64 weight over u64::MAX, ...), as a decimal string; value is derived from it (checked). Null without one.

Format: whole number, as a string
max_ratioobject

The highest take a hotkey may set.

3 fields in max_ratio
valuestring · unit ratio · 12 decimals · can be null

The value: the raw integer over its type's maximum, 12 decimals, 0..1 (checked). Null when neither stored nor declared.

Format: decimal number, as a string
basisstring · can be null

stored (a value in storage), default (none stored: the runtime's declared default) or runtime_constant (not in storage at all, e.g. the minimum stake). Null exactly with value. New values may be added; show an unknown value as is (or generically).

rawstring · unit count · can be null

The stored or default integer (a u16 take over 65535, a u64 weight over u64::MAX, ...), as a decimal string; value is derived from it (checked). Null without one.

Format: whole number, as a string
tao_weight_ratioobject

TaoWeight (u64 / u64::MAX): how much root stake counts in a subnet's stake weight.

3 fields in tao_weight_ratio
valuestring · unit ratio · 12 decimals · can be null

The value: the raw integer over its type's maximum, 12 decimals, 0..1 (checked). Null when neither stored nor declared.

Format: decimal number, as a string
basisstring · can be null

stored (a value in storage), default (none stored: the runtime's declared default) or runtime_constant (not in storage at all, e.g. the minimum stake). Null exactly with value. New values may be added; show an unknown value as is (or generically).

rawstring · unit count · can be null

The stored or default integer (a u16 take over 65535, a u64 weight over u64::MAX, ...), as a decimal string; value is derived from it (checked). Null without one.

Format: whole number, as a string
ck_burn_ratioobject

CKBurn (u64 / u64::MAX, one global value): the part of a childkey's take recycled, only when the parent's and the child's owners differ.

3 fields in ck_burn_ratio
valuestring · unit ratio · 12 decimals · can be null

The value: the raw integer over its type's maximum, 12 decimals, 0..1 (checked). Null when neither stored nor declared.

Format: decimal number, as a string
basisstring · can be null

stored (a value in storage), default (none stored: the runtime's declared default) or runtime_constant (not in storage at all, e.g. the minimum stake). Null exactly with value. New values may be added; show an unknown value as is (or generically).

rawstring · unit count · can be null

The stored or default integer (a u16 take over 65535, a u64 weight over u64::MAX, ...), as a decimal string; value is derived from it (checked). Null without one.

Format: whole number, as a string
min_stake_raoobject

DefaultMinStake: the smallest stake, rao of TAO (2,000,000), a runtime constant.

3 fields in min_stake_rao
valuestring · unit rao (÷1e9) · can be null

The amount, rao of TAO. Null when neither stored nor declared.

Format: whole number, as a string · on chain: u64
basisstring · can be null

stored (a value in storage), default (none stored: the runtime's declared default) or runtime_constant (not in storage at all, e.g. the minimum stake). Null exactly with value. New values may be added; show an unknown value as is (or generically).

rawstring · unit count · can be null

The stored or default integer (a u16 take over 65535, a u64 weight over u64::MAX, ...), as a decimal string; value is derived from it (checked). Null without one.

Format: whole number, as a string
root_stake_unlock_interval_blocksobject

RootStakeUnlockInterval: blocks before root stake (and anything landing as root stake) can leave.

3 fields in root_stake_unlock_interval_blocks
valuestring · unit blocks · can be null

The number of blocks, a u64 string. Null when neither stored nor declared.

Format: whole number, as a string
basisstring · can be null

stored (a value in storage), default (none stored: the runtime's declared default) or runtime_constant (not in storage at all, e.g. the minimum stake). Null exactly with value. New values may be added; show an unknown value as is (or generically).

rawstring · unit count · can be null

The stored or default integer (a u16 take over 65535, a u64 weight over u64::MAX, ...), as a decimal string; value is derived from it (checked). Null without one.

Format: whole number, as a string
subnetsarray of objects

Every live subnet, by netuid ascending (each once; checked).

6 fields in subnets (each item)
netuidinteger · unit id

The subnet slot (every live netuid, NetworksAdded).

fee_ratiostring · unit ratio · 12 decimals · can be null

The pool's swap fee: Swap.FeeRate / 65535, 12 decimals (equal to fee_rate_u16 / 65535, checked).

Format: decimal number, as a string
fee_rate_u16integer · unit u16_fraction (÷65535) · can be null

Swap.FeeRate, the raw u16 (over 65535).

fee_basisenum · can be null

Where the fee comes from.

One of: stored, default
childkey_take_floor_ratiostring · unit ratio · 12 decimals · can be null

The effective childkey take floor on this subnet: max(MinChildkeyTake, MinChildkeyTakePerSubnet(netuid)) / 65535, 12 decimals (at least the network's childkey_take.min_ratio, checked).

Format: decimal number, as a string
childkey_take_floor_basisenum · can be null

MinChildkeyTakePerSubnet(netuid)'s basis.

One of: stored, default
subnet_limitinteger · unit count · can be null

SubnetLimit: the most subnets that can be registered. Its basis is meta.basis's. Null on an answer read before the source served it.

subnets_including_rootinteger · unit count · can be null

The live netuids (NetworksAdded = true), root included: the length of subnets (checked; counted, so it has no basis). Null on an answer read before the source served it.

num_staking_coldkeysinteger · unit count · can be null

NumStakingColdkeys: the coldkeys holding any stake (the runtime's own counter). Its basis is meta.basis's. Null on an answer read before the source served it.

supplyobject · can be null

The TAO supply at meta.at: staked, issued and per-block emission. Its basis is meta.basis's. Null on an answer read before the source served it.

3 fields in supply
staked_tao_raostring · unit rao (÷1e9) · can be null

TotalStake: the TAO staked, rao (at most issuance_tao_rao, checked).

Format: whole number, as a string · on chain: u64
issuance_tao_raostring · unit rao (÷1e9) · can be null

TotalIssuance: the TAO issued, rao.

Format: whole number, as a string · on chain: u64
block_emission_tao_raostring · unit rao (÷1e9) · can be null

BlockEmission: the TAO issued per block, rao (it halves with the issuance).

Format: whole number, as a string · on chain: u64
network_last_lock_cost_tao_raostring · unit rao (÷1e9) · can be null

NetworkLastLockCost: the lock the last subnet registration paid, rao of TAO. Its basis is meta.basis's. Null on an answer read before the source served it.

Format: whole number, as a string · on chain: u64
network_min_lock_cost_tao_raostring · unit rao (÷1e9) · can be null

NetworkMinLockCost: the floor the runtime's decaying subnet lock cost never goes below, rao of TAO. Its basis is meta.basis's. Null on an answer read before the source served it.

Format: whole number, as a string · on chain: u64
network_rate_limit_blocksinteger · unit blocks · can be null

NetworkRateLimit: the blocks between two subnet registrations. Its basis is meta.basis's. Null on an answer read before the source served it.

subnet_owner_cut_ratiostring · unit ratio · 6 decimals · can be null

SubnetOwnerCut / 65535, 6 decimals: the subnet owner's share of its subnet's emission (equal to subnet_owner_cut_u16 / 65535 within the rounding, checked; the runtime's default when nothing is stored). Its basis is meta.basis's. Null on an answer read before the source served it.

Format: decimal number, as a string
subnet_owner_cut_u16integer · unit u16_fraction (÷65535) · can be null

SubnetOwnerCut as stored, a u16 (over 65535). Null exactly with subnet_owner_cut_ratio. Its basis is meta.basis's. Null on an answer read before the source served it.

nominator_min_required_stake_tao_raostring · unit rao (÷1e9) · can be null

NominatorMinRequiredStake: the least stake a nominator position may hold, rao of TAO. Its basis is meta.basis's. Null on an answer read before the source served it.

Format: whole number, as a string · on chain: u64
stake_threshold_tao_raostring · unit rao (÷1e9) · can be null

StakeThreshold: the least stake weight (rao) a hotkey needs for a validator permit (a stake below it counts as zero in the permit ranking; the subnet owner's hotkey is exempt). Read from chain state beside the parameters (meta.state_read); null when that read is unavailable.

Format: whole number, as a string · on chain: u64
stake_threshold_basisstring · can be null

Where stake_threshold_tao_rao comes from: stored or the runtime's default (nothing stored). Null exactly when it is null. New values may be added; show an unknown value as is (or generically).

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.