📖Story SRB

Learn how Story staking rewards are calculated. IPSRB formula covers the estimated APR from on-chain staking pool parameters and Cosmos SDK inflation mechanics.

IPSRB is a benchmark representing the mean, annualized staking rate across all active Story validators.

IPSRB is calculated and published by Staking Rewards via the Story Profile and Data API.

TL;DR: Story staking rewards are derived from the estimated APR published by the Story Foundation staking API, based on on-chain staking pool parameters. Story is a Cosmos SDK + EVM hybrid chain with delegation-based staking.

$$IPSRB = estimatedAPR$$

Formula key	Metric name	Description
estimatedAPR	Estimated APR	The annualized staking reward rate published by the Story Foundation staking API, derived from on-chain staking pool parameters and inflation mechanics.

• IPSRB takes into account all accumulated rewards, whether they have been claimed or remain unclaimed.

• IPSRB operates on a non-compounded basis, meaning it excludes returns generated from the reinvestment of rewards.

• Story is a Cosmos SDK + EVM hybrid chain. The staking layer follows Cosmos SDK delegation mechanics while execution runs on the EVM.

Slashing

Story implements slashing for validators. Validators can be slashed for double-signing and extended downtime. Delegators share in slashing penalties proportional to their delegation.

---

Story Validator Staking Rewards Rate: IPSRB(v)

Staking Rewards calculates the IPSRB for each validator based on their individual commission rate and uptime.

$$IPSRB(v) = IPSRB * (1 - cr) * u$$

Formula key	Metric name	Description
cr	Commission Rate	The percentage commission rate the validator has set as a delegation fee for all delegators.
u	Uptime	The validator's uptime percentage, representing availability and participation in consensus.

---

Observation Period:

1. IPSRB is determined based on the latest staking pool state and validator set at the point of evaluation.

2. 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

• IPSRB employs a 365-day convention for annualizing staking rewards. This convention remains consistent and does not accommodate adjustments for leap years.

• The estimated APR is sourced from the Story Foundation staking API and reflects the protocol's own calculation of expected returns.

• Individual validator returns vary based on commission rates and uptime.

---

IP Real Reward Rate (IPSRB^R)

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

$$IPSRB^R = (1+IPSRB) /(1+i)-1$$

Formula key	Metric name	Description
i	Inflation Rate	The annual inflation rate, calculated as inflations_per_year divided by the total token supply.

Inflation Rate Behaviour

Story's inflation is governed by Cosmos SDK mint parameters. The inflations_per_year parameter defines the total new IP tokens minted annually. The inflation rate is calculated as:

$$ir = inflationsPerYear / totalSupply$$

This rate adjusts dynamically as the total supply grows. The inflation mechanism is controlled by on-chain governance parameters via the Cosmos mint module.

---

Other Story metrics calculated by Staking Rewards:

Metric	Description
Delegated Tokens	The number of IP tokens delegated to validators by external delegators.
Self Staked Tokens	The number of IP tokens staked by validators directly from their own balance.
Staking Wallets	The total number of unique delegations on-chain.

---

Data Sources:

• Story Foundation Staking API (staking.storyapis.com) for estimated APR, staking pool data, and validator information

• Story Cosmos RPC (mainnet.storyrpc.io) for mint parameters and inflation data

• CoinGecko (price, circulating supply, total supply)

---

References:

• https://docs.story.foundation/

• https://www.story.foundation/

---

📚 Learn more about IP Staking

📊 Calculate your IP Staking Rewards

⚙️ Access historic Story Staking Data via API

Last updated on 03/24/2026