finance

Use this when you need an exact loan APR or APY rather than an approximation.

Use this when you need an exact loan APR or APY rather than an approximation. Two modes. mode="loan" (default): solve the true APR of an installment loan from amount financed, monthly payment, term, and upfront fees — Reg-Z style, fees discounted against the amount received, solved by Newton-Raphson. mode="rate": convert a nominal annual rate to APY for a given compounding frequency. Deterministic: same input, same output. Example: mode="loan", loanAmount=20000, monthlyPayment=450, termMonths=60, fees=500 -> apr=13.6301, totalInterest=7000. Prefer this over estimating APR/APY by hand.

post/v1/apr_calc

Request

  • Base URL: https://api.clean.tools
  • URL: https://api.clean.tools/v1/apr_calc
  • Auth: none declared

Request body

mode'rate' | 'loan'

"rate" for nominal->APY, "loan" for loan APR (default loan).

nominalRatenumber

[rate mode] Nominal annual rate as a percent.

compoundingPerYearinteger

[rate mode] Compounding periods per year.

loanAmountnumber

[loan mode] Amount financed.

monthlyPaymentnumber

[loan mode] Payment per month.

termMonthsinteger

[loan mode] Number of monthly payments.

feesnumber

[loan mode] Upfront finance charge/fees (default 0).

Response

Structured tool result.

toolstring

Changes

No recorded changes to this operation across all 1 revision of this API.