Skip to main content

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.overviewNetwork-wide staking metrics per epoch. This includes the total IOTA staked, rewards, and APR.
iota.staking.validator_stake_latestThe current amount of IOTA staked for each staker under each validator.
iota.staking.validator_rewardsDetailed rewards and performance metrics for each validator per epoch.
iota.staking.depositsRecords of all staking deposits made by stakers
iota.staking.withdrawalsRecords of all unstaking events made by stakers

Table Columns

Unique Key: epoch
ColumnDescription
checkpoint_dateDate and time of the checkpoint
epochThe epoch number
protocol_versionVersion of the IOTA protocol being used
active_validatorsNumber of active validators in the epoch
avg_validator_commission_rateAverage commission rate across all validators
aprAnnual Percentage Rate for staking (calculated)
stakeTotal amount of IOTA staked in the network
staking_rewardTotal staking rewards distributed in this epoch
cumulative_staking_rewardCumulative staking rewards distributed up to this epoch
minted_tokens_amountAmount of IOTA tokens minted during this epoch
burnt_tokens_amountAmount of IOTA tokens burnt during this epoch
total_gas_feesTotal gas fees (IOTA) collected during the epoch
tips_amountTotal tips amount collected during the epoch
storage_chargeTotal storage fees (IOTA) charged during the epoch
storage_rebateTotal storage rebates (IOTA) returned during the epoch
storage_fund_balanceCurrent balance of the storage fund
unique_idUnique identifier for the record
_created_atTimestamp when the record was created
_updated_atTimestamp 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.