Refinance break-even API
How many months of lower payments it takes to earn back the closing costs of a refinance, and the difference in total cost over the life of the loans.
POST https://api.curatedapi.com/v1/calc/finance/refinance-break-even
- Version 1
- MCP tool
calc_finance_refinance_break_even - Try it in the browser
Compares keeping a loan with replacing it. It works out the payment on what is left of the current loan and on the new loan, the monthly saving, and the break-even point: the first month by which the savings add up to the closing costs. It also totals every remaining payment on each side, because a lower payment over a longer term can still cost more in the end.
Formula
payment = P·r·(1+r)^n ÷ ((1+r)^n − 1); break-even = closing costs ÷ monthly saving, rounded up to a whole month
- Each month's interest is rounded to the cent and the last payment clears the balance, as on a lender's schedule.
- The break-even month does not count interest you could have earned on the closing costs, or tax effects.
- Amounts are plain numbers in any single currency; no currency conversion is done.
Inputs
Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).
| Input | Type | Description |
|---|---|---|
current_balance required |
decimal (string) | What is still owed. Allowed: > 0 and <= 1000000000000000. Unit: currency. |
current_rate_percent required |
decimal (string) | The current loan's annual rate. Allowed: >= 0 and <= 100. Unit: percent. |
remaining_months required |
integer | Months left on the current loan. Allowed: >= 1 and <= 600. |
new_rate_percent required |
decimal (string) | The new loan's annual rate. Allowed: >= 0 and <= 100. Unit: percent. |
new_term_months required |
integer | The new loan's term in months. Allowed: >= 1 and <= 600. |
closing_costs |
decimal (string) default 0 |
Fees and costs of the refinance. Allowed: >= 0 and <= 1000000000000000. Unit: currency. |
finance_closing_costs |
boolean default False |
true when the costs are added to the new loan instead of paid in cash. |
options.rounding |
half_even | half_up | half_down | up | down | ceiling | floor | Rounding mode applied once to each result. Default half_even. |
options.decimals |
integer | Round results to this many digits after the decimal point. |
Result
Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.
| Result | Type | Description |
|---|---|---|
current_payment | decimal (string) | Monthly payment on the current loan. Unit: currency. |
new_payment | decimal (string) | Monthly payment on the new loan. Unit: currency. |
monthly_saving | decimal (string) | current_payment − new_payment. Unit: currency. |
break_even_months | integer | The first month by which the monthly savings cover the closing costs. Absent when the new payment is not lower. |
current_total_remaining | decimal (string) | Every remaining payment on the current loan, added up. Unit: currency. |
new_total_cost | decimal (string) | Every payment on the new loan, plus the closing costs when paid in cash. Unit: currency. |
lifetime_saving | decimal (string) | current_total_remaining − new_total_cost; negative when the refinance costs more overall. Unit: currency. |
current_interest_remaining | decimal (string) | Interest still to pay on the current loan. Unit: currency. |
new_interest | decimal (string) | Interest on the new loan. Unit: currency. |
Examples
250,000 with 25 years left at 7%, refinanced at 6% for 5,000
curl https://api.curatedapi.com/v1/calc/finance/refinance-break-even \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"current_balance": "250000",
"current_rate_percent": "7",
"remaining_months": 300,
"new_rate_percent": "6",
"new_term_months": 300,
"closing_costs": "5000"
}'
{
"calculator": "finance/refinance-break-even@1",
"result": {
"current_payment": "1766.95",
"new_payment": "1610.75",
"monthly_saving": "156.20",
"break_even_months": 33,
"current_total_remaining": "530083.43",
"new_total_cost": "488227.37",
"lifetime_saving": "41856.06",
"current_interest_remaining": "280083.43",
"new_interest": "233227.37"
},
"exactness": {
"current_payment": "exact",
"new_payment": "exact",
"monthly_saving": "exact",
"current_total_remaining": "exact",
"new_total_cost": "exact",
"lifetime_saving": "exact",
"current_interest_remaining": "exact",
"new_interest": "exact"
},
"precision": {
"rounding": "half_even",
"decimals": 2
},
"inputs": {
"current_balance": "250000",
"current_rate_percent": "7",
"remaining_months": 300,
"new_rate_percent": "6",
"new_term_months": 300,
"closing_costs": "5000",
"finance_closing_costs": false
},
"formula": "payment = P·r·(1+r)^n ÷ ((1+r)^n − 1); break-even = closing costs ÷ monthly saving, rounded up to a whole month",
"references": [
{
"title": "CFPB Regulation Z Appendix H: sample Loan Estimate, the level payment the schedules here are checked against",
"url": "https://www.consumerfinance.gov/rules-policy/regulations/1026/h/"
}
],
"warnings": []
}
References
Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.
Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.