matrixMethod {bondAnalyst} | R Documentation |
Calculate Present Value or the Price of illiquid Bond using Matrix Method.
Description
Calculate Present Value or the Price of illiquid Bond using Matrix Method.
Usage
matrixMethod(couponPmt, times, maturityVal, n, r1, r2)
Arguments
couponPmt |
A vector. |
times |
A vector. |
maturityVal |
A number. |
n |
A number. |
r1 |
A number. |
r2 |
A number |
Details
Some fixed-rate bonds are not actively traded. Therefore, there is no market price available to calculate the rate of return required by investors. The same problem occurs for bonds that are not yet issued. In these situations, it is common to estimate the market discount rate and price based on the quoted or flat prices of more frequently traded comparable bonds. These comparable bonds have similar times-to-maturity, coupon rates, and credit quality. This estimation process is called matrix pricing. Matrix pricing also is used in underwriting new bonds to get an estimate of the required yield spread over the benchmark rate. The benchmark rate typically is the yield-to-maturity on a government bond having the same, or close to the same, time-to-maturity (Adams & Smith, 2019).
Based on the information provided, matrixMethod()
is developed to compute the Price of Bond using Matrix Method. So, matrixMethod()
gives the Price of Bond using returns of two frequently traded comparable bonds for values passed to its six arguments. Here, couponPmt
represents the dollar values of all the coupon payments, times
is a vector of number of years ranging from 1 to any specified number of years till maturity, maturityVal
is Maturity Value, n
is number of years till maturity, r1
return on first comparable bond, and r2
is return on second comparable bond. The function computes simple average of the returns of two comparable bonds with r=(r1+r2)/2
, that is being used for Bond pricing. The output is rounded off to three decimal places.
Value
Input values to six arguments couponPmt
,times
, maturityVal
,n
, r1
and r2
.
Author(s)
MaheshP Kumar, maheshparamjitkumar@gmail.com
References
Adams,J.F. & Smith,D.J.(2019). Introduction to fixed-income valuation. In CFA Program Curriculum 2020 Level I Volumes 1-6. (Vol. 5, pp. 107-151). Wiley Professional Development (P&T). ISBN 9781119593577, https://bookshelf.vitalsource.com/books/9781119593577
Examples
matrixMethod(couponPmt=c(4.5,4.5,4.5,4.5),times=c(1:4),maturityVal=100,n=4,r1=0.02856,r2=0.03449)