Portfolio Function

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

Portfolio Function

Previous pageReturn to chapter overviewNext page

 

The PortfolioBin function calculates the theoretical price, sensitivities, the implied volatility, the implied strike and the implied correlation value of an American or European style portfolio option using a three dimensional binomial model. See Multiple Asset Options for a further explanation.

 

 

PortfolioBin

(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 a European style portfolio put where the option is 90 days from expiration, the first asset price is $38, the second asset price is $42, the exercise price is $80, the risk-free interest rate is 7% per annum, the yield rate of the first and second assets are both 3% per annum, the correlation is 0.6, the annual volatility of the first asset is 25%, and the annual volatility of the second asset is 30%. All rates are considered continuous, the quantities are set to 1 and Iterations = 10. So,

Input

 

Output

Variable

Value

 

Function

Name

Value

ExerciseType

European

 

1

Theoretical:

3.507535

OptionType

Put

 

4

Theta:

-0.016940

Asset1:

38

 

7

Rho:

-0.091063

Asset2:

42

 

11

Strike Sensitivity:

0.461639

Strike:

80

 

13

Implied Strike:

79.983679

TimeExpire

90

 

30

Delta Asset 1:

-0.424477

Volatility1:

25%

 

31

Delta Asset 2:

-0.411749

Volatility2:

30%

 

32

Gamma 1:

0.041206

InterestRate

7%

 

33

Gamma 2:

0.040487

YieldRate1:

3%

 

34

Implied Vol. 1:

0.248801

YieldRate2:

3%

 

35

Implied Vol. 2:

0.299000

Correlation:

0.6

 

36

Vega Vol. 1:

0.062841

Iterations

10

 

37

Vega Vol. 2:

0.075288

QtyAsset1

1

 

38

Psi Yield 1:

0.039773

QtyAsset2

1

 

39

Psi Yield 2:

0.042641

MarketPrice:

3.5

 

42

Lambda 1:

-4.598704

TimeFormat

Days

 

43

Lambda 2:

-4.930375

 

 

 

48

Chi:

1.135984

 

 

 

50

Implied Corr:

0.593416

 

 

See Also

Dual Strike

Exchange

Exchange Binomial

Exchange on Exchange

Rainbow

Rainbow Binomial

Spread

Spread Binomial

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.