omni_staking_rewards_apr_apy
Calculate net staking APR/APY, validator commission, and compounded annual token or USD rewards for proof-of-stake networks from staked amount, token price, base APR, fee, and compounding frequency.
Instructions
Proof-of-Stake Validator Staking Yield (APR vs APY) Calculator. Calculate annual staking returns, validator commission deduction, and compound APY for Ethereum, Solana, Cosmos, and Avalanche proof-of-stake networks. Discipline: CRYPTO. Governing mathematical model / formula: APY = (1 + [APR · (1 - Commission)] / n)ⁿ - 1 | Terminal Value = Principal × (1 + APY)ᵗ.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of net_annual_apy_pct (Net Effective APY), annual_dollar_earnings (Annual Staking Yield ($ USD)), annual_token_rewards (Tokens Earned Per Year), commission_paid_usd (Validator Fee Paid) using staked_token_amount (Staked Token Quantity in Tokens (e.g. ETH)), token_price_usd (Token Market Price ($)), network_base_apr_pct (Network Gross Staking APR (%) in %), validator_commission_pct (Validator / Pool Fee (%) in %), compounding_frequency (Reward Compounding (1=Annual, 12=Monthly, 365=Daily)). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Proof-of-Stake Validator Staking Yield (APR vs APY) Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "staking-rewards-apr-apy"
category (string): "crypto"
name (string): "Proof-of-Stake Validator Staking Yield (APR vs APY) Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.net_annual_apy_pct (Net Effective APY): Formatted display string (e.g. '4.07%')
metrics.annual_dollar_earnings (Annual Staking Yield ($ USD)): Formatted display string (e.g. '$4,168.00 / yr')
metrics.annual_token_rewards (Tokens Earned Per Year): Formatted display string (e.g. '1.30 Tokens')
metrics.commission_paid_usd (Validator Fee Paid): Formatted display string (e.g. '$219.00 / yr')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_staking_rewards_apr_apy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token_price_usd | No | Token Market Price ($). Current spot exchange price. Default: 3200. Min: 0.1. Max: 100000. | |
| staked_token_amount | No | Staked Token Quantity (Tokens (e.g. ETH)). Number of native tokens staked. Default: 32. Min: 0.1. Max: 100000. | |
| network_base_apr_pct | No | Network Gross Staking APR (%) (%). Protocol emission rate plus MEV tips. Default: 4.2. Min: 1. Max: 50. | |
| compounding_frequency | No | Reward Compounding (1=Annual, 12=Monthly, 365=Daily). Compounding frequency of restaked rewards. Default: 365. Min: 1. Max: 365. | |
| validator_commission_pct | No | Validator / Pool Fee (%) (%). Staking pool fee (e.g. Lido = 10%, Rocket Pool = 8%). Default: 5. Min: 0. Max: 25. |