compound_wealth
Simulate long-term compound interest growth for retirement portfolios, 401(k)s, Roth IRAs, UK ISAs, or European ETF savings plans (Sparplan) with recurring monthly deposits.
Behavior: Deterministic, idempotent calculation with zero external side effects. Applies discrete compound interest formula with periodic annuity deposits: Future Value = P*(1 + r/n)^(nt) + PMT(((1 + r/n)^(n*t) - 1)/(r/n)). Returns final accumulated balance, total principal contributed, total compound interest earned, and annual wealth progression milestone table.
Usage Guidelines: Use for multi-year personal wealth projection and retirement nest-egg simulations. Do not use for Indian mutual fund monthly SIPs with annual step-up; use sip_investment instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| principal | No | Initial lump-sum deposit or starting balance in currency units. Must be non-negative. | |
| tenureYears | Yes | Investment horizon in years (e.g. 10, 20, 30). Must be an integer >= 1. | |
| monthlyDeposit | No | Recurring monthly contribution added to the account. Must be non-negative. | |
| annualRatePercent | Yes | Expected annualized investment return rate percentage (e.g. 8 for 8%). Must be positive. | |
| compoundFrequency | No | Number of compounding periods per year (1 for annual, 4 for quarterly, 12 for monthly). |