TotalStake

Storage Plain v101 → v411

Total TAO staked across all hotkeys.

Queried by: analyticsvalidatorswallets

The Big Picture

Total stake represents the aggregate economic commitment to Bittensor's security. Higher total stake means more TAO is actively participating in consensus rather than sitting idle. This single number reflects network-wide confidence in validation.

Why This Matters

Want to know how much TAO is actively working in the network? This is the headline number for staking participation - the total value backing all validators combined.

Example Scenario

Query TotalStake() returns 150000000000000000000 (150M TAO in RAO). Divide by 10^9 to get 150 million TAO staked network-wide. Compare to TotalIssuance to get staking ratio.

Common Questions

Does this include all subnets?: Yes, this is the aggregate across all subnets and all hotkeys on the entire network.
How often does this update?: Updates with every stake/unstake operation, so it reflects real-time network state.

Use Cases

Calculate staking ratio (total staked vs total supply)
Track network-wide staking trends over time
Monitor economic health of the network
Build dashboard metrics for ecosystem health

From Chain Metadata

ITEM ( total_stake )

Purpose & Usage

Purpose

Global network stake tracking for consensus and economics.

Common Query Patterns

Single value query for network-wide stake

Part of: Stake Operations

Stored Value

u64

Total TAO staked network-wide in RAO (÷10⁹ for TAO). Source-level type is `TaoCurrency` newtype, surfaced as `u64` in chain metadata.

Source src/lib.rs:1281-1282

RAO -> TAO (/ 10^9)

Relationships

Modified By

add_stake add_stake_limit remove_stake remove_stake_full_limit remove_stake_limit unstake_all unstake_all_alpha

Code Examples

import { createClient, Binary } from "polkadot-api";
import { getWsProvider } from "polkadot-api/ws";
import { sub } from "@polkadot-api/descriptors"; // generated by: npx papi add sub -w wss://entrypoint-finney.opentensor.ai:443

const client = createClient(getWsProvider("wss://entrypoint-finney.opentensor.ai:443"));
const api = client.getTypedApi(sub);

// Query TotalStake storage (no keys - plain value)
const result = await api.query.SubtensorModule.TotalStake.getValue();
console.log("TotalStake:", result);

On-Chain Activity

Write Frequency

●●●●●● Ultra-High >10M est. writes

>10M estimated writes

#8 most written storage item

Write Source User Extrinsics

Modified via user-submitted extrinsics

As of block 7,429,232

Version History

Version:

v101 block 1 Added

v353–v360 · runtime versions skipped on chain (never deployed)

v361 block 7,063,679 Internal re-bind Current

Runtime Info

View Source

Pallet: SubtensorModule
Storage Kind: Plain
First Version: v101
Current Version: v411

Back to SubtensorModule Storage