Rate definitions
Each rate describes a different cash flow, reward asset and denominator. Unstaked liquidity earns trading fees; gauge-staked liquidity earns emissions. Voters receive notified fee and incentive funding.
Liquidity provider rates
Fee APR and Emissions APR are separate earning modes. Partially staked V2 positions can have both sources, and previously accrued claims can survive a custody change. Concentrated positions stake as whole NFTs.
Fee APR
The multichain API reports trailing seven-day Fee APR: (fees7dUsd × 365 / 7) / tvlUsd × 100. This simple annualization assumes no compounding. The numerator is the API’s observed seven-day fees, not today’s UTC bucket and not a client-side estimate.
Pool Fee APR describes unstaked liquidity. Personal fee amounts and their valuation are separate from this pool reference rate. Missing pricing or an incomplete window can make the rate unavailable.
Emissions APR
For a streaming gauge, annualized reward-token flow is rewardRate × 31,536,000 × rewardPriceUsd. A V2 rate divides that flow by the relevant staked value. Reward assets are TOPAZ on BNB Chain and xTOPAZ on the spokes. Killed or expired gauges are not active emission streams.
The API records the source, reward rate and applicable denominator. Do not add Fee APR to Emissions APR for the same unit of staked liquidity.
Concentrated emissions
Pool listings show the API’s reference $100 deposit at its specified range, using active staked liquidity and accounting for the reference deposit’s dilution. Read aprProfile and aprScenario for the actual range, methodology and any cap or fallback.
Personal positions use their actual staked liquidity and range. An out-of-range position cannot assume the reference in-range return. A pool-wide TVL denominator and an active-liquidity denominator answer different questions.
Voter rates
Voter APR measures epoch funding relative to the value of votes competing for it; it is separate from LP returns.
Voter APR
Voter APR = (epoch fees + epoch incentives) / valued voting weight × 52 × 100. The page uses funding for the requested epoch and distinguishes unavailable valuation from a confirmed zero.
Hub veTOPAZ power and spoke xTOPAZ voting shares have different units. Display chain, voting asset, epoch and observation time. Adding votes dilutes the same reward pot; a current reference APR does not promise the return on a new vote.
APR and APY
APR is simple annualization without compounding. APY requires an explicit reinvestment schedule. Claimed veTOPAZ rebases and growth in xTOPAZ assets per share do not make an unrelated pool or voter APR an APY.
Other Topaz products
Relays, Topaz Flow and Topaz Vaults have their own reward mechanics. Their rates must state the cash flow, asset, period, denominator, compounding assumption and observation time.
xTOPAZ and cross-network comparisons
xTOPAZ backing is locked TOPAZ per canonical share. Backing value, local market price and voting-share value are different measurements. Do not sum canonical shares with their bridged representations, or treat a receiver’s last delivered rate as a new hub observation.
Combined protocol TVL and flow metrics are additive across eligible pools; APR percentages, holder counts and local vote units are not simply additive across networks.