Overview

Table Details

Property	Value
Table Name	`iota.staking.overview`
Table Status	Production-Ready

Staking Overview

The iota.staking.overview model provides a comprehensive view of staking metrics at the epoch level across the entire IOTA network. It only inclues data post-IOTA migration to the Move ecosystem. Staking involves delegating IOTA tokens to validators to participate in network consensus. Stakers earn rewards for helping secure the network, while validators earn commission for operating nodes.

Key Concepts

Epoch: A time period in IOTA after which rewards are distributed
Staker/Delegator: Users who delegate their IOTA to validators
Validator: Node operators who validate transactions and produce blocks
APR: Annual Percentage Rate, the annualized return on staked IOTA

Staking Model

Our IOTA staking data is organized into the following models:

Model
iota.staking.overview	Network-wide staking metrics per epoch. This includes the total IOTA staked, rewards, and APR.
iota.staking.validator_stake_latest	The current amount of IOTA staked for each staker under each validator.
iota.staking.validator_rewards	Detailed rewards and performance metrics for each validator per epoch.
iota.staking.deposits	Records of all staking deposits made by stakers
iota.staking.withdrawals	Records of all unstaking events made by stakers

Table Columns

Column Name	Data Type	Description
checkpoint_date	TIMESTAMP_NTZ(9)	Date and time of the checkpoint
epoch	NUMBER(38,0)	The epoch number
protocol_version	NUMBER(38,0)	Version of the IOTA protocol being used
active_validators	NUMBER(38,0)	Number of active validators in the epoch
avg_validator_commission_rate	FLOAT	Average commission rate across all validators
apr	FLOAT	Annual Percentage Rate for staking (calculated)
stake	FLOAT	Total amount of IOTA staked in the network
staking_reward	FLOAT	Total staking rewards distributed in this epoch
cumulative_staking_reward	FLOAT	Cumulative staking rewards distributed up to this epoch
minted_tokens_amount	FLOAT	Amount of IOTA tokens minted during this epoch
burnt_tokens_amount	FLOAT	Amount of IOTA tokens burnt during this epoch
total_gas_fees	FLOAT	Total gas fees (IOTA) collected during the epoch
tips_amount	FLOAT	Total tips amount collected during the epoch
storage_charge	FLOAT	Total storage fees (IOTA) charged during the epoch
storage_rebate	FLOAT	Total storage rebates (IOTA) returned during the epoch
storage_fund_balance	FLOAT	Current balance of the storage fund
unique_id	VARCHAR(16777216)	Unique identifier for the record
_created_at	TIMESTAMP_NTZ(9)	Timestamp when the record was created
_updated_at	TIMESTAMP_NTZ(9)	Timestamp when the record was last updated

APR Calculation

The APR is calculated by dividing the total rewards distributed for the epoch by the total stake and multiplying by 365 * 100.

Sui Staking Overview

Data Verticals

Solana

Hyperliquid

Lighter

Bitcoin Ecosystem

EVM

Cosmos Ecosystem

Move Ecosystem

Other Ecosystems

Overview

Table Details

Staking Overview

Key Concepts

Staking Model

Table Columns

APR Calculation

​Table Details

​Staking Overview

​Key Concepts

​Staking Model

​Table Columns

​APR Calculation

​Related Docs

Table Details

Staking Overview

Key Concepts

Staking Model

Table Columns

APR Calculation

Related Docs