Retirement savings projection API

Project a retirement balance from current savings plus monthly contributions using the future-value-of-an-annuity formula FV = PV(1+r/12)^(12t) + PMT·[((1+r/12)^(12t)−1)/(r/12)], returning projected balance, total contributed, and investment growth. Answers 'how much will I have at 65','retirement projection with monthly contributions','will my 401k be enough'.

Price$0.01per request

MethodPOST

Route/v1/calc/pf-retirement-savings

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcretirementfuture-valueannuity401ksavingspersonal-financeprojection

API URLhttps://x402.hexl.dev/v1/calc/pf-retirement-savings

Integration docs

Example request

{
  "currentSavings": 50000,
  "monthlyContribution": 1000,
  "currentAge": 30,
  "retirementAge": 65,
  "annualReturnPercent": 7
}

Example response

{
  "formula": "FV = PV(1+r/12)^(12t) + PMT·[((1+r/12)^(12t)−1)/(r/12)]",
  "projectedBalance": 2376362.19,
  "totalContributed": 470000,
  "investmentGrowth": 1906362.19,
  "yearsToRetirement": 35,
  "breakdown": {
    "currentSavings": 50000,
    "monthlyContribution": 1000,
    "annualReturnPercent": 7,
    "currentAge": 30,
    "retirementAge": 65
  }
}

Input schema

{
  "type": "object",
  "required": [
    "currentSavings",
    "monthlyContribution",
    "currentAge",
    "retirementAge",
    "annualReturnPercent"
  ],
  "properties": {
    "currentSavings": {
      "type": "number",
      "examples": [
        50000
      ]
    },
    "monthlyContribution": {
      "type": "number",
      "examples": [
        1000
      ]
    },
    "currentAge": {
      "type": "number",
      "examples": [
        30
      ]
    },
    "retirementAge": {
      "type": "number",
      "examples": [
        65
      ]
    },
    "annualReturnPercent": {
      "type": "number",
      "examples": [
        7
      ]
    }
  }
}

Output schema

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