zeroprice

Price zero-coupon instruments given yield

Syntax

Price = zeroprice(Yield,Settle,Maturity)

Price = zeroprice(___,Period,Basis,EndMonthRule)

Description

Price = zeroprice(Yield,Settle,Maturity) prices zero-coupon instruments given a yield. zeroprice calculates the prices for a portfolio of general short and long-term zero-coupon instruments given the yield of reference bonds. In other words, if the zero-coupon computed with this yield is used to discount the reference bond, the value of that reference bond is equal to its price.

example

Price = zeroprice(___,Period,Basis,EndMonthRule) adds optional arguments for Period, Basis, and EndMonthRule.

example

Examples

collapse all

Compute the Price of a Short-Term Zero-Coupon Instrument

Open Live Script

This example shows how to compute the price of a short-term zero-coupon instrument.

Settle = datetime(1993,6,24);
Maturity = datetime(1993,11,1);
Period = 2;
Basis = 0;
Yield = 0.04;

Price = zeroprice(Yield, Settle, Maturity, Period, Basis)

Price = 
98.6066

Compute the Prices of a Portfolio of Two Zero-Coupon Instruments

Open Live Script

This example shows how to compute the prices of a portfolio of two zero-coupon instruments, one short-term, and the other long-term.

Settle = datetime(1993,6,24);
Maturity = [datetime(1993,11,1) ; datetime(2024,1,15)];
Basis = [0; 1];
Yield = [0.04; 0.1];

Price = zeroprice(Yield, Settle, Maturity, [], Basis)

Price = 2×1

   98.6066
    5.0697

Input Arguments

collapse all

`Yield` — Reference bond yield
scalar | vector

Reference bond yield, specified as a scalar or a NZERO-by-1 vector.

Data Types: double

`Settle` — Settlement date
datetime array | string array | date character vector

Settlement date, specified as a NZERO-by-1 vector using a datetime array, string array, or date character vectors.

To support existing code, zeroprice also accepts serial date numbers as inputs, but they are not recommended.

`Maturity` — Maturity date
datetime array | string array | date character vector

Maturity date, specified as a NZERO-by-1 vector using a datetime array, string array, or date character vectors.

To support existing code, zeroprice also accepts serial date numbers as inputs, but they are not recommended.

`Period` — Number of coupons in one year
`2` (semiannual) (default) | vector of positive integers from the set `[1,2,3,4,6,12]`

(Optional) Number of coupons in one year, specified as a positive integer for the values 1,2,4,6,12 in a NZERO-by-1 vector.

Data Types: double

`Basis` — Day-count basis of bond
`0` (actual/actual) (default) | vector of positive integers of the set `[1...13]`

(Optional) Day-count basis of the bond, specified as a positive integer using a NZERO-by-1 vector.

0 = actual/actual
1 = 30/360 (SIA)
2 = actual/360
3 = actual/365
4 = 30/360 (PSA)
5 = 30/360 (ISDA)
6 = 30/360 (European)
7 = actual/365 (Japanese)
8 = actual/actual (ICMA)
9 = actual/360 (ICMA)
10 = actual/365 (ICMA)
11 = 30/360E (ICMA)
12 = actual/365 (ISDA)
13 = BUS/252

For more information, see Basis.

Data Types: double

`EndMonthRule` — End-of-month rule flag
`1` (in effect) (default) | nonnegative integer with value of `0` or `1`

(Optional) End-of-month rule flag, specified as a nonnegative integer with a value of 0 or 1 using a NZERO-by-1 vector. This rule applies only when Maturity is an end-of-month date for a month having 30 or fewer days.

0 = Ignore rule, meaning that a bond coupon payment date is always the same numerical day of the month.
1 = Set rule on, meaning that a bond coupon payment date is always the last actual day of the month.

Data Types: double

Output Arguments

collapse all

`Price` — Price for each zero-coupon instrument
vector

Price for each zero-coupon instrument (per $100 notional), returned as a column vector.

Algorithms

To compute the price when Period is 1 or 0 for the quasi-coupon periods to redemption, zeroprice uses the formula

$P r i c e = \frac{R V}{1 + (\frac{D S R}{E} \times \frac{Y}{M})}$

Quasi-coupon periods are the coupon periods that would exist if the bond were paying interest at a rate other than zero.

When there is more than one quasi-coupon period to the redemption date, zeroprice uses the formula

$P r i c e = \frac{R V}{{(1 + \frac{Y}{M})}^{N q - 1 + \frac{D S C}{E}}}$

The elements of the equations are defined as follows.

Variable	Definition
DSC	Number of days from settlement date to next quasi-coupon date as if the security paid periodic interest.
DSR	Number of days from settlement date to the redemption date (call date, put date, and so on).
E	Number of days in quasi-coupon period.
M	Number of quasi-coupon periods per year (standard for the particular security involved).
Nq	Number of quasi-coupon periods between settlement date and redemption date. If this number contains a fractional part, raise it to the next whole number.
Price	Dollar price per $100 par value.
RV	Redemption value.
Y	Annual yield (decimal) when held to redemption.

References

[1] Mayle, Jan. Standard Securities Calculation Methods. 3rd Edition, Vol. 1, Securities Industry Association, Inc., New York, 1993, ISBN 1-882936-01-9. Vol. 2, 1994, ISBN 1-882936-02-7.

Version History

Introduced before R2006a

expand all

R2022b: Serial date numbers not recommended

Although zeroprice supports serial date numbers, datetime values are recommended instead. The datetime data type provides flexible date and time formats, storage out to nanosecond precision, and properties to account for time zones and daylight saving time.

To convert serial date numbers or text to datetime values, use the datetime function. For example:

t = datetime(738427.656845093,"ConvertFrom","datenum");
y = year(t)

y =

        2021

There are no plans to remove support for serial date number inputs.

zeroprice

Syntax

Description

Examples

Compute the Price of a Short-Term Zero-Coupon Instrument

Compute the Prices of a Portfolio of Two Zero-Coupon Instruments

Input Arguments

`Yield` — Reference bond yield
scalar | vector

`Settle` — Settlement date
datetime array | string array | date character vector

`Maturity` — Maturity date
datetime array | string array | date character vector

`Period` — Number of coupons in one year
`2` (semiannual) (default) | vector of positive integers from the set `[1,2,3,4,6,12]`

`Basis` — Day-count basis of bond
`0` (actual/actual) (default) | vector of positive integers of the set `[1...13]`

`EndMonthRule` — End-of-month rule flag
`1` (in effect) (default) | nonnegative integer with value of `0` or `1`

Output Arguments

`Price` — Price for each zero-coupon instrument
vector

Algorithms

References

Version History

R2022b: Serial date numbers not recommended

See Also

Topics

zeroprice

Syntax

Description

Examples

Compute the Price of a Short-Term Zero-Coupon Instrument

Compute the Prices of a Portfolio of Two Zero-Coupon Instruments

Input Arguments

Yield — Reference bond yield scalar | vector

Settle — Settlement date datetime array | string array | date character vector

Maturity — Maturity date datetime array | string array | date character vector

Period — Number of coupons in one year 2 (semiannual) (default) | vector of positive integers from the set [1,2,3,4,6,12]

Basis — Day-count basis of bond 0 (actual/actual) (default) | vector of positive integers of the set [1...13]

EndMonthRule — End-of-month rule flag 1 (in effect) (default) | nonnegative integer with value of 0 or 1

Output Arguments

Price — Price for each zero-coupon instrument vector

Algorithms

References

Version History

R2022b: Serial date numbers not recommended

See Also

Topics

`Yield` — Reference bond yield
scalar | vector

`Settle` — Settlement date
datetime array | string array | date character vector

`Maturity` — Maturity date
datetime array | string array | date character vector

`Period` — Number of coupons in one year
`2` (semiannual) (default) | vector of positive integers from the set `[1,2,3,4,6,12]`

`Basis` — Day-count basis of bond
`0` (actual/actual) (default) | vector of positive integers of the set `[1...13]`

`EndMonthRule` — End-of-month rule flag
`1` (in effect) (default) | nonnegative integer with value of `0` or `1`

`Price` — Price for each zero-coupon instrument
vector