Portfolio

Age-based equity/bond glidepath

Generates an age-based equity/bond allocation path — the target the rebalance endpoint aims at as the investor ages. The rule_of_thumb method sets equity = clamp((rule_base − age)/100, floor, ceiling) (the "own your age in bonds" family). The linear (target-date) method glides equity from start_equity at current_age to end_equity at retirement_age, then holds it ("to") or continues to final_equity at final_age ("through"). Returns a year-by-year path plus the current, retirement, and end allocations. Deterministic; not investment advice.

post/v1/portfolio/glidepath

Request

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

Request body

current_ageinteger required
end_ageinteger required

Project the path through this age (>= current_age).

method'rule_of_thumb' | 'linear'
rule_basenumber

rule_of_thumb: equity = (rule_base − age)/100. Omit for 110.

equity_floornumber

rule_of_thumb lower clamp. Omit for 0.20, or set 0 to allow an all-bonds floor.

equity_ceilingnumber

rule_of_thumb upper clamp. Omit for 0.95.

retirement_ageinteger

linear: the glide landing age.

start_equitynumber

linear: equity at current_age.

end_equitynumber

linear: equity at retirement_age.

glide_type'to' | 'through'

linear: hold after retirement (to) or keep gliding (through).

final_equitynumber

through: equity reached by final_age. Omit = end_equity; set 0 to glide to an all-bonds landing.

final_ageinteger

through: age final_equity is reached. Omit = end_age.

Response

The generated glidepath

result_idstring
engine_versionstring
disclaimerstring

Example response

{
  "result_id": "glidepath_1a2b3c4d5e6f7a8b",
  "engine_version": "glidepath-1.0.0"
}

Changes

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