Long-horizon wealth-path stress (savings / withdrawal plans)
long_horizon_stressUSE WHEN you want multi-year wealth paths for a savings plan or a withdrawal plan. Distribution of multi-year wealth paths for a savings plan (monthly_contribution) or a withdrawal plan (monthly_withdrawal, inflation-indexed by default) on a SPY/TLT/GOLD/BTC portfolio. Multi-year paths chain ~2y model blocks (block-bootstrap); long-run drift is RE-ANCHORED to stated round-number assumptions (overridable via long_run_drift; see assumptions.long_run_drift) while the model's path shape is kept; both are echoed. Costs are ON by default. Returns terminal-wealth quantiles (nominal + real), ruin/shortfall probabilities, a sequence-of-returns diagnosis and a drift sensitivity (assumptions - 2pp). Descriptive, not advisory; no rate, allocation or product is recommended.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"holdings": "<holdings>",
"horizon_years": "<horizon_years>"
},
"name": "long_horizon_stress"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| holdings | Yes | Portfolio legs: list of {asset, weight} objects, e.g. [{'asset': 'SPY', 'weight': 0.6}, {'asset': 'TLT', 'weight': 0.4}]. Assets: SPY, TLT, GOLD, BTC (aliases GLD, BTC-USD). Weights are non-negative and normalised to sum to 1; at most 50 legs, no duplicates. | |
| rebalance | No | Rebalancing frequency: 'daily' | 'monthly' | 'quarterly'. | monthly |
| horizon_years | Yes | Plan horizon in years (multi-year paths are chained from ~2-year model blocks). | |
| target_amount | No | Optional wealth target; the output reports the probability of reaching it. | |
| long_run_drift | No | Override the re-anchored long-run drift per asset: {ASSET: annual drift fraction}; omit for the stated round-number assumptions (assumptions.long_run_drift in the response). | |
| annual_inflation | No | Annual inflation assumption for indexing and real-value reporting (fraction, default 0.02). | |
| initial_investment | No | Starting capital (account currency). | |
| monthly_withdrawal | No | Monthly withdrawal (withdrawal-plan mode); inflation-indexed when withdrawal_inflation_indexed is true. | |
| monthly_contribution | No | Fixed monthly savings contribution (savings-plan mode). | |
| withdrawal_inflation_indexed | No | Index the monthly withdrawal to inflation. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |