Formualizer Docs
ReferenceFunctionsFinancial Functions

RATE

Solves for the periodic interest rate implied by annuity cash flows.

Summary

This function uses Newton-Raphson iteration and returns the per-period rate that satisfies the TVM equation.

Remarks

  • Output is a rate per period; convert to annual terms externally if needed.
  • Cash-flow sign convention matters for convergence: use opposite signs for borrow/repay sides.
  • guess defaults to 0.1 and influences convergence speed and branch selection.
  • type = 0 means end-of-period payments; type != 0 means beginning-of-period payments.
  • Returns #NUM! on non-convergence, near-zero derivative, or unsatisfied numeric conditions.

Examples

Example
Grid
CellValue
No inputs on Sheet1.
Formula
=
Result
Not evaluated yet.
Expected
null
Example
Grid
CellValue
No inputs on Sheet1.
Formula
=
Result
Not evaluated yet.
Expected
null

FAQ

How important is guess for RATE?

RATE uses Newton-Raphson from guess (default 0.1); a poor starting point can lead to non-convergence and #NUM!.

Runtime metadata

Category

Financial

Signature

RATE(arg1: Number, arg2: Number, arg3: Number, arg4: Number, arg5: Number, arg6…: Number)

Arity

min 3, max variadic

Arguments

arg1

Number · Scalar · coercion NumberLenientText

arg2

Number · Scalar · coercion NumberLenientText

arg3

Number · Scalar · coercion NumberLenientText

arg4

Number · Scalar · coercion NumberLenientText

arg5

Number · Scalar · coercion NumberLenientText

arg6

Number · Scalar · coercion NumberLenientText

Caps

PURE

Source

On this page