Staking rewards & effective APY calculator API

Project staking rewards by compounding a nominal APR net of validator commission: final = principal·(1+netAPR/n)^(n·years), netAPR = APR·(1−commission), with effective APY = (1+netAPR/n)^n − 1. Deterministic compounding math. Answers 'how much will I earn staking','effective APY after commission','staking rewards over a year'.

Price$0.01per request

MethodPOST

Route/v1/calc/cryptocalc-staking-rewards

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calccryptodefistakingrewardsapycompoundingvalidator

API URLhttps://x402.hexl.dev/v1/calc/cryptocalc-staking-rewards

Integration docs

Example request

{
  "principal": 1000,
  "apr": 0.07,
  "years": 1,
  "commission": 0.05
}

Example response

{
  "formula": "final = principal·(1+netAPR/n)^(n·years); netAPR = APR·(1−commission)",
  "principal": 1000,
  "grossAprPct": 7,
  "commissionPct": 5,
  "netAprPct": 6.65,
  "effectiveApyPct": 6.8754,
  "finalBalance": 1068.75449,
  "rewardsEarned": 68.75449,
  "interpretation": "moderate"
}

Input schema

{
  "type": "object",
  "required": [
    "principal",
    "apr",
    "years"
  ],
  "properties": {
    "principal": {
      "type": "number",
      "description": "staked amount",
      "examples": [
        1000
      ]
    },
    "apr": {
      "type": "number",
      "description": "gross APR (decimal)",
      "examples": [
        0.07
      ]
    },
    "years": {
      "type": "number",
      "examples": [
        1
      ]
    },
    "compoundsPerYear": {
      "type": "number",
      "examples": [
        365
      ]
    },
    "commission": {
      "type": "number",
      "description": "validator commission (decimal)",
      "examples": [
        0.05
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}