compare_balance_transfer

Compare staying on your current home loan vs refinancing to a lower rate — net saving, switching cost, breakeven month. Not financial advice.

Endpoint POST https://api.avnester.com/public/v1/compare_balance_transfer

Parameters

The most-used parameters. Full schema in the OpenAPI document.

Name	Type	Required	Description
outstandingPrincipal	number	required	Current outstanding principal in INR.
currentRatePercent	number	required	Current annual interest rate (%).
newRatePercent	number	required	New lender annual interest rate (%).
remainingTenureYears	number	required	Years left on the loan.
processingFeePct	number	optional	New-lender processing fee on the balance (%). Defaults to 0.5%.
flatCosts	number	optional	Flat legal + valuation charges in INR. Defaults to ₹12,500.

Worked example

# transfer a ₹30L loan from 9.5% to 8.0%, 15 years left

curl -X POST https://api.avnester.com/public/v1/compare_balance_transfer \
  -H 'Content-Type: application/json' \
  -d '{
       "outstandingPrincipal": 3000000,
       "currentRatePercent": 9.5,
       "newRatePercent": 8.0,
       "remainingTenureYears": 15
     }'

Response

{
  "currentEmi": 31328,
  "newEmi": 28670,
  "monthlyEmiSaving": 2658,
  "grossInterestSaved": 478000,
  "switchingCost": 27500,
  "netSaving": 450500,
  "breakevenMonths": 11,
  "worthIt": true,
  "attribution": "AVnester",
  "disclaimer": "..."
}

Rate limits

Anonymous

60/min

OAuth (Team)

600/min

Per-IP aggregate cap (across all tools): 60/min. OAuth registration lifts both the per-tool budget (10×) and removes the IP cap.

Common errors

400Invalid request body
Check required parameters and types. The error.message field will name the offending parameter.
429Rate limit exceeded
Back off until the time in the Retry-After header; or authenticate with OAuth for the 10× tier.

Next steps

→ Try compare_balance_transfer in the playground (no signup, anon tier)
→ Register an OAuth client (10× rate budget)
→ Browse the other 6 tools
→ Full schema in the OpenAPI spec