Simulate home-loan prepayment (calculator)
simulate_loan_prepaymentSimulate prepaying / repaying an Indian home loan early. Pure deterministic math — no advice, no loan-approval claim. Use for "should I prepay", "early/part/lump-sum repayment", "pay extra each month", "reduce EMI or tenure", "interest saved", or foreclosure. Modes: one-time, recurring yearly, or a fixed extra every month (recurring_monthly). Compares reduce_tenure (keep EMI, finish early) vs reduce_emi (keep tenure, lower EMI). Always surface the disclaimer field.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| strategy | No | reduce_tenure keeps the EMI and finishes early (bigger saving); reduce_emi keeps the tenure and lowers the EMI; compare_both returns both. | compare_both |
| prepaymentMode | No | How the prepayment is made (annual anniversary vs every month). | one_time |
| prepaymentAmount | No | One-time lump-sum prepayment in INR (one_time / one_time_plus_recurring* modes). | |
| annualRatePercent | No | Current annual interest rate (percent). Defaults to the indicative market rate when omitted. | |
| outstandingPrincipal | Yes | Current outstanding home-loan principal in INR. | |
| remainingTenureYears | Yes | Years left on the loan at the current EMI. | |
| recurringAnnualAmount | No | Recurring yearly prepayment in INR (recurring_annual / one_time_plus_recurring modes). | |
| recurringMonthlyAmount | No | Fixed extra paid toward principal EVERY month on top of the EMI (recurring_monthly / one_time_plus_recurring_monthly modes). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cards | Yes | ||
| applied | Yes | ||
| baseline | Yes | ||
| strategy | Yes | ||
| reduceEmi | No | ||
| disclaimer | Yes | ||
| assumptions | Yes | ||
| attribution | Yes | ||
| reduceTenure | No | ||
| prepaymentMode | Yes | ||
| annualRatePercent | Yes | ||
| outstandingPrincipal | Yes | ||
| remainingTenureYears | Yes |