calculate_us_401k
Calculate US 401(k) retirement savings: employee contribution, employer match, and total annual amount. Input salary, contribution percentage, employer match terms, and age to determine catch-up eligibility and contribution limits.
Instructions
Calculate US 401(k) contribution, employer match, and total retirement savings. Returns: {annual_salary, employee_contribution, employer_match, total_annual_contribution, catch_up_eligible, max_employee_limit}. See list_bundles for related 'finance-us' calculators.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| annual_salary | Yes | Annual salary in USD | |
| contribution_pct | Yes | Employee contribution percentage (1-100) | |
| employer_match_pct | No | Employer match percentage of employee contribution (default 50%) | |
| employer_match_limit | No | Employer match cap as % of salary (default 6%) | |
| age | No | Employee age (50+ enables catch-up contributions) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | Computed result. Object whose fields depend on the tool (e.g. {tax, marginal_rate, brackets} for tax tools, {volume_l, gallons} for volume tools). | |
| formula | No | Human-readable formula or method used (e.g. "I=P·r·t", "Magnus formula"). | |
| source | No | Authoritative source for the rule or formula (e.g. "Article 197 CGI", "NF DTU 21"). | |
| reference_url | No | Link to a calcul2 page documenting the calculation in detail. |