finance

Use this when you have four of the five time-value-of-money variables (N periods, I/Y annual rate percent, PV, PMT, FV) and need the fifth - annuity, loan, or investment problems - instead of solving the equation by hand.

Use this when you have four of the five time-value-of-money variables (N periods, I/Y annual rate percent, PV, PMT, FV) and need the fifth - annuity, loan, or investment problems - instead of solving the equation by hand. Solving for I/Y uses Newton-Raphson (no closed form). Supports compoundingPerYear and annuityDue (payments at the beginning of each period). Follows the cash-flow sign convention (outflows negative). Deterministic: same input, same output. Example: solveFor 'fv', n 120, iy 6, pv -10000, pmt -200, compoundingPerYear 12 -> result 50969.84. result holds the solved value; iy is rounded to 4 decimals, all others to 2.

post/v1/tvm_solve

Request

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

Request body

solveFor'n' | 'iy' | 'pv' | 'pmt' | 'fv' required

Which variable to solve for.

nnumber

Number of periods.

iynumber

Interest rate per year as a percent.

pvnumber

Present value (cash-flow sign convention).

pmtnumber

Payment per period.

fvnumber

Future value.

compoundingPerYearinteger

Compounding periods per year (default 1).

annuityDueboolean

True if payments occur at the beginning of each period (default false = ordinary annuity).

Response

Structured tool result.

toolstring

Changes

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