Retirement

Required savings to fund a target retirement income

The inverse of an accumulation projection: given a target retirement income, other income (SS/pension), and return/inflation assumptions, returns the required nest egg, the annual/monthly saving needed from today, and the gap versus the current trajectory. Works in real (today's) dollars. For a success-probability target, pair with the Monte Carlo endpoint. Deterministic.

post/v1/retirement/savings-target

Request

  • Base URL: https://api.numeratica.com
  • URL: https://api.numeratica.com/v1/retirement/savings-target
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

annual_fee_ratenumber double

All-in annual cost drag as a decimal (0.01 = 1%): advisory fee plus fund expense ratios, applied as a reduction to the expected return. Omitted or 0 means the projection is GROSS of fees, which leaves result_id unchanged. Costs compound: a 1% load moves long-horizon outcomes by a large margin (see the Concepts page).

current_ageinteger required
retirement_ageinteger required
end_ageinteger required
target_annual_incomenumber required

Today's dollars.

other_incomenumber

SS/pension at retirement, today's dollars.

current_savingsnumber
expected_returnnumber required

Nominal.

inflationnumber
withdrawal_ratenumber

Optional; adds a rule-of-thumb nest egg (gap / rate).

success_probability_targetnumber

Optional. When set, runs a Monte Carlo search for the smallest annual saving meeting this success rate.

return_volatilitynumber

Real-return volatility for the Monte Carlo search.

num_simulationsinteger

Required (> 0) when success_probability_target is set.

seedinteger

Optional; generated and echoed when a target is set.

Example request

{
  "annual_fee_rate": 0.01,
  "current_age": 40,
  "retirement_age": 65,
  "end_age": 90,
  "target_annual_income": 80000,
  "expected_return": 0.06
}

Response

Savings analysis

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "svt_1a2b3c4d5e6f7a8b",
  "engine_version": "savings-target-1.0.0",
  "inputs": {
    "annual_fee_rate": 0.01,
    "current_age": 40,
    "retirement_age": 65,
    "end_age": 90,
    "target_annual_income": 80000,
    "expected_return": 0.06
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.