Spread Binomial Function

Navigation:  Available Functions > Exotic Option Functions > Multiple Asset Option Functions >

Spread Binomial Function

Previous pageReturn to chapter overviewNext page

 

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

Dual Strike

Exchange

Exchange Binomial

Exchange on Exchange

Portfolio

Rainbow

Rainbow Binomial

Spread

Two Asset Correlation

 

 

Remark

For a further example on this model see the included Excel Template located in the root directory of the add-in. This example can be accessed through the Multiple Asset Template menu item after the add-in has been installed properly.

 

A list of all of the possible Error Messages is included for convenience.