Finance[AmericanSwaption] - create a new American-style swaption
|
Calling Sequence
|
|
AmericanSwaption(irswap, earliestexercise, latestexercise, opts)
|
|
Parameters
|
|
irswap
|
-
|
simple swap data structures; interest rate swap
|
earliestexercise
|
-
|
a non-negative constant, a string containing a date specification in a format recognized by ParseDate, or a date data structure; the earliest date or time when the option can be exercised
|
latestexercise
|
-
|
a non-negative constant, a string containing a date specification in a format recognized by ParseDate, or a date data structure; the maturity time or date
|
opts
|
-
|
(optional) equation(s) of the form option = value where option is one of referencedate or daycounter; specify options for the AmericanSwaption command
|
|
|
|
|
Description
|
|
•
|
The AmericanSwaption command creates a new American-style swaption with the specified payoff and maturity. The swaption can be exercised at any time between earliestexercise and latestexercise dates. This is the opposite of a European-style swaption, which can only be exercised on the date of expiration.
|
•
|
The parameter irswap is the underlying interest rate swap (see InterestRateSwap for more details).
|
•
|
The parameter earliestexercise specifies the earliest time or date when the option can be exercised. It can be given either as a non-negative constant or as a date in any of the formats recognized by the ParseDate command. If earlyexercise is given as a date, then the period between referencedate and earliestexercise will be converted to a fraction of the year according to the day count convention specified by daycounter. Typically the value of this option is , which means that the option can be exercised at any time until the maturity. Note that the time of the earliest exercise must preceed the maturity time.
|
•
|
The parameter latestexercise specifies the maturity time of the option. It can be given either as a non-negative constant or as a date in any of the formats recognized by the ParseDate command. If earlyexercise is given as a date, then the period between referencedate and latestexercise will be converted to a fraction of the year according to the day count convention specified by daycounter.
|
•
|
The LatticePrice command can be used to price an American-style swaption using any given binomial or trinomial tree.
|
|
|
Options
|
|
•
|
referencedate = a string containing a date specification in a format recognized by ParseDate or a date data structure -- This option provides the evaluation date. It is set to the global evaluation date by default.
|
•
|
daycounter = a name representing a supported day counter (e.g. ISDA, Simple) or a day counter data structure created using the DayCounter constructor -- This option provides a day counter that will be used to convert the period between two dates to a fraction of the year. This option is used only if one of earliestexercise or latestexercise is specified as a date.
|
|
|
Compatibility
|
|
•
|
The Finance[AmericanSwaption] command was introduced in Maple 15.
|
|
|
Examples
|
|
>
|
|
>
|
|
>
|
|
| (1) |
>
|
|
| (2) |
>
|
|
| (3) |
>
|
|
| (4) |
>
|
|
| (5) |
>
|
|
| (6) |
>
|
|
| (7) |
>
|
|
| (8) |
>
|
|
| (9) |
Construct an interest rate swap receiving the fixed-rate payments in exchange for the floating-rate payment.
>
|
|
| (10) |
Compute the at-the-money rate for this interest rate swap.
>
|
|
| (11) |
Construct three swaps.
>
|
|
| (12) |
>
|
|
| (13) |
>
|
|
| (14) |
Here are cash flows for the paying leg of your interest rate swap.
>
|
|
| (15) |
Here are cash flows for the receiving leg of your interest rate swap.
>
|
|
| (16) |
These are days when coupon payments are scheduled to occur.
>
|
|
| (17) |
>
|
|
| (18) |
>
|
|
| (19) |
>
|
|
| (20) |
Price these swaptions using the Hull-White trinomial tree.
>
|
|
| (21) |
>
|
|
| (22) |
>
|
|
| (23) |
>
|
|
| (24) |
>
|
|
| (25) |
Price the swaptions using the tree constructed above.
>
|
|
| (26) |
>
|
|
| (27) |
>
|
|
| (28) |
You can also price these swaptions using an explicitly constructed trinomial tree.
>
|
|
| (29) |
>
|
|
| (30) |
Price your swaptions using the second tree.
>
|
|
| (31) |
>
|
|
| (32) |
>
|
|
| (33) |
|
|
See Also
|
|
Finance[BermudanSwaption], Finance[BinomialTree], Finance[BlackScholesBinomialTree], Finance[BlackScholesTrinomialTree], Finance[EuropeanSwaption], Finance[GetDescendants], Finance[GetProbabilities], Finance[GetUnderlying], Finance[ImpliedBinomialTree], Finance[ImpliedTrinomialTree], Finance[LatticeMethods], Finance[LatticePrice], Finance[MultinomialTree], Finance[SetDescendants], Finance[SetProbabilities], Finance[SetUnderlying], Finance[StochasticProcesses], Finance[TreePlot], Finance[TrinomialTree]
|
|
References
|
|
|
Brigo, D., Mercurio, F., Interest Rate Models: Theory and Practice. New York: Springer-Verlag, 2001.
|
|
Hull, J., Options, Futures, and Other Derivatives, 5th. edition. Upper Saddle River, New Jersey: Prentice Hall, 2003.
|
|
|