For the complete documentation index, see llms.txt. This page is also available as Markdown.

💧Sui SRB

Learn how Sui staking rewards are calculated. SUISRB formula covers 30-day average epoch rewards, total staked SUI, validator commission, and epoch-based distribution.

SUISRB is a benchmark representing the mean, annualized staking rate across all active Sui validators.

SUISRB is calculated and published by Staking Rewards via the Sui Profile and Data API.

TL;DR: Sui staking rewards are calculated from the 30-day rolling average of daily epoch rewards distributed to all validators, divided by total staked SUI and annualized over 365 days. The averaging window smooths fluctuations from variable epoch durations.

SUISRB=epochRewardsAvg30d×365/stakedTokensSUISRB = epochRewardsAvg30d \times 365 / stakedTokens
Formula key
Metric name
Description

epochRewardsAvg30d

30-Day Average Epoch Rewards

The 30-day rolling average of total daily staking rewards distributed to all validators. Derived from on-chain ValidatorEpochInfoEventV2 events, which record each validator's pool_staking_reward per epoch. Rewards are summed across all active validators and averaged over 30 days to smooth epoch-to-epoch variance.

stakedTokens

Staked Tokens

Total SUI tokens staked across all active validators, sourced from the on-chain system state (validators.total_stake), read via the Sui GraphQL RPC.

  • SUISRB is non-compounded and represents the staking rate before reinvesting rewards.

  • Includes both claimed and unclaimed staking rewards.

  • Epoch rewards are annualized using a 365-day year convention.

  • The 30-day averaging window smooths fluctuations from variable epoch durations and reward distributions.

Slashing

  1. SUISRB does not factor in the possibility of slashing occurrences.

  2. Sui does not currently implement token slashing for validators.


SUI Validator Staking Reward Rate: SUISRB(v)

Staking Rewards calculates the SUISRB for each validator by adjusting the asset-level benchmark for that validator's commission.

SUISRB(v)=SUISRB×(1−cv)SUISRB(v) = SUISRB \times (1 - c_v)
Formula key
Metric name
Description

SUISRB

Sui SRB

The asset-level benchmark defined above.

c_v

Commission

Validator v's commission, read from commission_rate in the on-chain system state. Sui stores this in basis points, so it is divided by 10,000 to give a fraction.

Note: Sui previously exposed a per-validator APY directly through the suix_getValidatorsApy JSON-RPC method, which Staking Rewards used verbatim. Sui is decommissioning that interface and it has no replacement — the migration guide directs consumers to compute APY client-side. Measured across all 128 active validators, the commission-adjusted benchmark above tracks the retired APY figure to within 0.021 percentage points on average (0.006 pp median), while keeping validator rates on the same non-compounded basis as the asset-level benchmark.


Observation Period:

  1. The SUISRB is determined based on the latest epoch data at the point of evaluation.

  2. Epoch rewards are averaged over a 30-day rolling window.

  3. This data is then annualized for a comprehensive year-long projection.

Calculation

The calculation happens every 2 hours and is immediately published via Data API.

Limitations

  1. SUISRB employs a 365-day convention for annualizing epoch rewards. This convention remains consistent and does not accommodate adjustments for leap years.

  2. Epoch duration on Sui is approximately 24 hours but can vary. The 30-day averaging window mitigates this variability.

  3. SUISRB does not account for gas rebates or other non-staking rewards.

  4. Individual validator rates may differ from the asset-level benchmark depending on their commission rate and performance.

  5. SUISRB(v) accounts for each validator's commission but not its individual reward performance, so a validator that misses rewards in a given epoch may realise less than its stated rate.

SUI Real Reward Rate: SUISRB^R

The real reward rate calculates the SUISRB adjusted for inflation in the network.

SUISRBR=(1+SUISRB)/(1+ir)−1SUISRB^R = (1 + SUISRB) / (1 + ir) - 1
Formula key
Metric name
Description

ir

Inflation Rate

The annualized inflation rate, computed as: epochRewardsAvg30d * 365 / circulatingSupply, where circulatingSupply is sourced from CoinGecko market data.

Inflation Rate Behavior

Sui's inflation is determined by the staking reward distribution mechanism. Validators receive SUI tokens as staking rewards from a pre-defined supply schedule. The effective inflation rate depends on the total epoch rewards distributed relative to the circulating supply. Unlike chains with a fixed inflation schedule, Sui's reward distribution is governed by the protocol's tokenomics and storage fund mechanics.


Other Sui metrics calculated by Staking Rewards:

Metric
Description

Delegated Tokens

The number of SUI tokens delegated to validators (total staked minus self-staked).

Self Staked Tokens

The number of SUI tokens staked by validators from their own wallet, derived from the StakedSui objects owned by the validator's address, restricted to its own staking pool.

Staking Wallets

Total number of unique delegations per validator, sourced from the Blockberry validators API.

Epoch Rewards

The 30-day rolling average of the total staking rewards distributed per epoch, sourced from on-chain ValidatorEpochInfoEventV2 events. This is the epochRewardsAvg30d term in the formula above; the latest single-epoch figure is published separately as Epoch Rewards 24h.

Epoch Duration

Duration of the current epoch in seconds, derived from the parameters.epoch_duration_ms field in the on-chain system state.

Lockup Time

The commitment period before a delegator can request a withdrawal. Sui has none, so this is 0 seconds.

Unstaking Time

The delay between requesting a withdrawal and the stake becoming liquid. Withdrawals settle at the next epoch boundary, so this equals the epoch duration (~24 hours).

Data Sources:


References:


📚 Learn more about SUI Staking

📊 Calculate your SUI Staking Rewards

⚙️ Access historic Sui Staking Data via API

Last updated