Overview

Staking Overview

The sui.staking.overview model provides a comprehensive view of staking metrics at the epoch level across the entire Sui network. Staking involves delegating SUI 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 Sui (approximately 24 hours) after which rewards are distributed
Staker/Delegator: Users who delegate their SUI to validators
Validator: Node operators who validate transactions and produce blocks
APR: Annual Percentage Rate, the annualized return on staked SUI

Staking Model

Our Sui staking data is organized into the following models:

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

Table Columns

Unique Key: epoch

Column	Description
checkpoint_date	Date and time of the checkpoint
epoch	The epoch number
protocol_version	Version of the Sui protocol being used
active_validators	Number of active validators in the epoch
avg_validator_commission_rate	Average commission rate across all validators
apr	Annual Percentage Rate for staking (calculated)
stake	Total amount of SUI staked in the network
staking_reward	Total staking rewards distributed in this epoch
cumulative_staking_reward	Cumulative staking rewards distributed up to this epoch
stake_subsidy_amount	Amount of new SUI distributed as staking subsidies
reference_gas_price	Network-wide reference gas price for the epoch
total_gas_fees	Total gas fees collected during the epoch
storage_charge	Total storage fees charged during the epoch
storage_rebate	Total storage rebates returned during the epoch
storage_fund_reinvestment	Amount reinvested into the storage fund
storage_fund_balance	Current balance of the storage fund
total_stake_rewards_distributed	Total rewards distributed to stakers in this epoch
leftover_storage_fund_inflow	Remaining storage fund inflow after distributions
total_storage_fund_staking_reward	Sum of all storage fund staking rewards across validators

APR Calculation

The APR is calculated by dividing the total rewards distributed for the epoch by the total stake and multiplying by 365.25 (accounting for leap years) * 100.

Data Verticals

Solana

Hyperliquid

Lighter

Bitcoin Ecosystem

EVM

Cosmos Ecosystem

Move Ecosystem

Other Ecosystems

Overview

Staking Overview

Key Concepts

Staking Model

Table Columns

APR Calculation

​Staking Overview

​Key Concepts

​Staking Model

​Table Columns

​APR Calculation

Staking Overview

Key Concepts

Staking Model

Table Columns

APR Calculation