# YIELDMAT

financial · from excel · excel: not yet compared · sheets: not yet compared

annual yield of a security paying interest at maturity

## signature

```
YIELDMAT(settlement, maturity, issue, rate, pr, [basis])
```

returns: `number`

## arguments

- settlement: number — required
- maturity: number — required
- issue: number — required
- rate: number — required
- pr: number — required
- basis: number — optional

## examples

formula and result, asserted in the engine test suite.

| formula | result | with |
| --- | --- | --- |
| `=YIELDMAT(DATE(2026,1,15), DATE(2026,12,15), DATE(2025,6,1), 0.05, 99)` | `0.059649816994757215` | — |

## errors

error values observed from the engine — each with a call that produces it.

| error | produced by |
| --- | --- |
| `#NUM!` | `=YIELDMAT(2, 2, 2, 0.05, 2)` |

## related

- [ACCRINT](https://deepcalc.com/functions/accrint.md) — accrued interest for a security paying periodic interest
- [ACCRINTM](https://deepcalc.com/functions/accrintm.md) — accrued interest for a security paying at maturity
- [AMORDEGRC](https://deepcalc.com/functions/amordegrc.md) — depreciation per period, French accounting, degressive
- [AMORLINC](https://deepcalc.com/functions/amorlinc.md) — depreciation per period, French accounting, linear
- [COUPDAYBS](https://deepcalc.com/functions/coupdaybs.md) — days from coupon period start to settlement
- [COUPDAYS](https://deepcalc.com/functions/coupdays.md) — days in the coupon period containing settlement
- [COUPDAYSNC](https://deepcalc.com/functions/coupdaysnc.md) — days from settlement to the next coupon date
- [COUPNCD](https://deepcalc.com/functions/coupncd.md) — next coupon date after settlement

## navigate

- [all financial functions](https://deepcalc.com/functions/financial-functions.md)
- [function index](https://deepcalc.com/functions.md) — all 600 functions
- [error values](https://deepcalc.com/errors.md) · [concepts](https://deepcalc.com/concepts.md) · [limits](https://deepcalc.com/limits.md)
- [everything in one file](https://deepcalc.com/llms-full.txt)

source: https://deepcalc.com/functions/yieldmat