The SpreadBin function calculates the theoretical price, sensitivities, the implied volatility, the implied strike and the implied correlation value of an American or European style spread option using a three dimensional binomial model. See Multiple Asset Options for a further explanation.
SpreadBin |
(ExerciseType, OptionType, ModelStatistic, Asset1, Asset2, Strike, TimeExpire, Volatility1, Volatility2, InterestRate, YieldRate1, YieldRate2, Correlation, Iterations, QtyAsset1, QtyAsset2, MarketPrice, TimeFormat, InterestType, Yield1Type, Yield2Type) |
Note: Optional arguments are shown in Italics. MarketPrice is not Optional for the Implied Calculations.
Argument |
Description |
ExerciseType |
Alphanumeric value indicating the exercise type: •American = 0 or "a" (case insensitive) •European = 1 or "e" (case insensitive) |
OptionType |
Alphanumeric value indicating the type of option: •Call = 1 or "c" (case insensitive) •Put = 2 or "p" (case insensitive) |
ModelStatistic |
Numeric value indicating the type of function required for the return value: •Theoretical = 1 •Theta = 4 •Rho = 7 •StrikeSensitivity = 11 •ImpliedStrike = 13 •Delta1 = 30 •Delta2 = 31 •Gamma1 = 32 •Gamma2 = 33 •ImpliedVol1 = 34 •ImpliedVol2 = 35 •Vega1 = 36 •Vega2 = 37 •Psi1 = 38 •Psi2 = 39 •Lambda1 = 42 •Lambda2 = 43 •Chi = 48 •ImpliedCorrelation = 50 |
Asset1 |
The price of the underlying asset one. Must be > 0. |
Asset2 |
The price of the underlying asset two. Must be > 0. |
Strike |
The price at which the asset can be purchased if the option is a call or sold if the option is a put. Must be > 0. |
TimeExpire |
Time, expressed in either Days or Years (depending on the TimeFormat value), until the options expiration. Must be > 0. |
Volatility1 |
Annualized volatility of the asset one. Must be > 0. |
Volatility2 |
Annualized volatility of the asset two. Must be > 0. |
InterestRate |
Risk-free interest rate expressed as a percentage. This rate is interpreted as a continuously compounded rate unless otherwise specified in the InterestType argument. Must be > 0. |
YieldRate1 |
Yield, expressed as a percentage (dividends or interest yield), of the first underlying asset price. This rate is interpreted as a continuously compounded rate unless specified otherwise in the Yield1Type argument. |
YieldRate2 |
Yield, expressed as a percentage (dividends or interest yield), of the second underlying asset price. This rate is interpreted as a continuously compounded rate unless specified otherwise in the Yield2Type argument. |
Correlation |
The correlation between the first underlying asset price and the second underlying asset price. Must be -1 < Correlation < 1. |
Iterations |
The number of iterations used for the model. Must be between 5 and 100. As the number of iterations increase, the time required for a calculation increases exponentially. Good results can be obtained with 30 iterations. |
QtyAsset1 |
Optional. The quantity of asset one. If omitted, QtyAsset1=1. QtyAsset1 must be > 0. |
QtyAsset2 |
Optional. The quantity of asset two. If omitted, QtyAsset2=1. QtyAsset2 must be > 0. |
MarketPrice |
Optional. The selling price of the option in the marketplace. This input is required when implied volatility and strike are calculated. Price must be > 0. |
TimeFormat |
Optional. Alphanumeric value indicating the format of the time arguments (i.e. TimeExpire). If omitted, Days are used as the default. Specified as either: •Days = 0 or "D" (case insensitive) •Years = 1 or "Y" (case insensitive) |
InterestType |
Optional. Alphanumeric value indicating the type of InterestRate to use when evaluating the option. This value is converted to Continuously Compounded for the calculations. If omitted, a Continuously Compounded rate is used. |
Yield1Type |
Optional. Alphanumeric value indicating the type of YieldRate1 to use when evaluating the option. This value is converted to Continuously Compounded for the calculations. If omitted, a Continuously Compounded rate is used. |
Yield2Type |
Optional. Alphanumeric value indicating the type of YieldRate2 to use when evaluating the option. This value is converted to Continuously Compounded for the calculations. If omitted, a Continuously Compounded rate is used. |
Example
Calculate all of functions of an American style spread call option where the option is 90 days from expiration. The first asset price is $24, the second asset price is $20, the exercise price is -$2 (which is $2 out of the money), the risk-free interest rate is 9% per annum, the yield rate of the first and second assets are both 7% per annum, the correlation is 0.25, the annual volatility of the first asset is 20%, and the annual volatility of the second asset is 25%. All rates are considered continuous, the quantities are set to 1 and Iterations = 30. So, |
Input |
|
Output |
|||
Variable |
Value |
|
Function |
Name |
Value |
ExerciseType |
American |
|
1 |
Theoretical: |
6.000748 |
OptionType |
Call |
|
4 |
Theta: |
-0.000246 |
Asset1: |
24 |
|
7 |
Rho: |
-0.000648 |
Asset2: |
20 |
|
11 |
Strike Sensitivity: |
-0.988740 |
Strike: |
-2 |
|
13 |
Implied Strike: |
-1.999243 |
TimeExpire |
90 |
|
30 |
Delta Asset 1: |
0.990266 |
Volatility1: |
20% |
|
31 |
Delta Asset 2: |
-0.987156 |
Volatility2: |
25% |
|
32 |
Gamma 1: |
0.019162 |
InterestRate |
9% |
|
33 |
Gamma 2: |
0.029862 |
YieldRate1: |
7% |
|
34 |
Implied Vol. 1: |
0.190000 |
YieldRate2: |
7% |
|
35 |
Implied Vol. 2: |
0.240000 |
Correlation: |
0.25 |
|
36 |
Vega Vol. 1: |
0.001007 |
Iterations |
30 |
|
37 |
Vega Vol. 2: |
0.001957 |
QtyAsset1 |
1 |
|
38 |
Psi Yield 1: |
-0.007692 |
QtyAsset2 |
1 |
|
39 |
Psi Yield 2: |
0.006757 |
MarketPrice: |
6 |
|
42 |
Lambda 1: |
3.960570 |
TimeFormat |
Days |
|
43 |
Lambda 2: |
-3.290109 |
|
|
|
48 |
Chi: |
-0.042575 |
|
|
|
50 |
Implied Corr: |
0.260579 |
See Also