Documentation

How key metrics on Flare Metrics are defined and calculated.

Reward Rate

The Reward Rate (displayed as fspRewardRate) represents the FTSO Scaling Provider reward rate derived from WNAT (Wrapped Native Asset Token) claims.

It reflects how effectively a data provider is earning rewards relative to the delegation it receives. A higher reward rate indicates stronger provider performance over the measured period.

Values greater than or equal to 1 are considered anomalous and are displayed as -- in the UI. Valid reward rates are shown to four decimal places.

The Reward Rate CV (coefficient of variation) measures the consistency of a provider's reward rate across epochs. A lower CV indicates more stable, predictable performance.

Staking APR

The Staking APR estimates the annualised return for delegators staking to a specific validator node. Each node is calculated independently. APRs are never averaged across the nodes of an entity, so node-level configuration (fees, uptime) is fully visible.

Per-epoch reward rate

For each reward epoch and validator node, two reward rates are computed and summed:

normalRate = nodeRewardAfterFee / totalStakeAtEpochEnd × 100

mirrorRate = mirrorClaimPool / stakeWeightAtVotePowerBlock × 100

combinedRate = normalRate + mirrorRate

  • normalRate: the node’s reward (after the validator fee is deducted) divided by its total stake at epoch end. A node with a 100% fee contributes 0 here.
  • mirrorRate: the MIRROR claim pool for that node divided by the stake weight at the vote-power block (a separate snapshot). The denominator is intentionally different from normalRate’s, since MIRROR rewards are paid to a different stake basis.

If combinedRate is 0 or has no valid inputs for the epoch, the rate for that node/epoch is treated as missing and excluded from downstream smoothing.

Annualisation

To turn the per-epoch rate into the APR shown on the validator table:

  1. Take the most recent up-to-4 epochs with a valid combined rate for the node (newest first).
  2. Smooth with a simple moving average (SMA) over that window.
  3. Annualise by multiplying the SMA by epochsPerYear, derived dynamically from the actual elapsed time between the last two reward epochs (≈ 104 for 3.5-day epochs; falls back to 104 when fewer than two epochs are available).

The single-epoch rate (latest), the smoothed rate (SMA), and the annualised value (SMA × epochsPerYear) are all persisted on each stake using only that stake’s own validator’s metrics.

Notes

  • Closed or expired stakes (end time in the past) have all three APR fields cleared.
  • Actual returns vary as reward amounts, fees, and delegation totals change each epoch.
  • Nodes with a 100% delegation fee (or otherwise no rewards in any of the last 4 epochs) show “no data” rather than a literal 0% APR.

Data source: flare-foundation/reward-scripts

FSP APR

The FSP APR (FTSO Scaling Provider APR) represents the estimated annualised return for delegators based on FTSO reward distributions.

To filter out unreliable outliers, FSP APR values exceeding 15% are hidden from the UI and displayed as --.