Overview
Fetch the current balance of SUI staked, rewards,
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.