Utilities

Compute the contribution required to reach a savings goal

Given a target amount, a horizon, an expected return, and any current savings, computes the periodic contribution needed to reach the goal. Deterministic.

post/v1/goal-funding

Request

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

Request body

target_amountnumber required

Future amount to reach (nominal).

current_savingsnumber
yearsnumber required

Horizon in years (> 0, <= 200).

annual_returnnumber required

Expected nominal annual return (> -1, <= 1).

periods_per_yearinteger

Contribution frequency (1–366).

contributions_at_beginningboolean

Example request

{
  "target_amount": 1000000,
  "current_savings": 50000,
  "years": 30,
  "annual_return": 0.06,
  "periods_per_year": 12
}

Response

Funding plan

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "goal_1a2b3c4d5e6f7a8b",
  "engine_version": "goalfunding-1.0.0",
  "inputs": {
    "target_amount": 1000000,
    "current_savings": 50000,
    "years": 30,
    "annual_return": 0.06,
    "periods_per_year": 12
  }
}

Changes

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