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.
guessdefaults to0.1and influences convergence speed and branch selection.type = 0means end-of-period payments;type != 0means beginning-of-period payments.- Returns
#NUM!on non-convergence, near-zero derivative, or unsatisfied numeric conditions.
Examples
Example
Grid
| Cell | Value | |
|---|---|---|
| No inputs on Sheet1. | ||
Formula
=
Result
Not evaluated yet.
Expected
null
Example
Grid
| Cell | Value | |
|---|---|---|
| No inputs on Sheet1. | ||
Formula
=
Result
Not evaluated yet.
Expected
null
Related functions
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
arg1Number · Scalar · coercion NumberLenientText
arg2Number · Scalar · coercion NumberLenientText
arg3Number · Scalar · coercion NumberLenientText
arg4Number · Scalar · coercion NumberLenientText
arg5Number · Scalar · coercion NumberLenientText
arg6Number · Scalar · coercion NumberLenientText
Caps
PURE
Source