price

Compute price for interest-rate, equity, or credit derivative instrument with Analytic pricer

Syntax

[Price,PriceResult] = price(inpPricer,inpInstrument)

[Price,PriceResult] = price(___,inpSensitivity)

Description

[Price,PriceResult] = price(inpPricer,inpInstrument) computes the instrument price and related pricing information based on the pricing object inpPricer and the instrument object inpInstrument.

The Analytic pricer supports the following pricer objects:

• BjerksundStensland

• IkedaKunitomo

• Black

• BlackScholes

• CDSBlack

• ConzeViswanathan

• GoldmanSosinGatto

• HullWhite

• Heston

• KemnaVorst

• Kirk

• Levy

• Normal

• RollGeskeWhaley

• SABR

• TurnbullWakeman

[Price,PriceResult] = price(___,inpSensitivity) adds an optional argument to specify sensitivities.

Examples

Use Bjerksund-Stensland Pricer and Black-Scholes Model to Price Spread Instrument

This example shows the workflow to price a European exercise Spread instrument when you use a BlackScholes model and a BjerksundStensland pricing method.

Create Spread Instrument Object

Use fininstrument to create a Spread instrument object.

SpreadOpt = fininstrument("Spread",'Strike',5,'ExerciseDate',datetime(2021,9,15),'OptionType',"put",'ExerciseStyle',"european",'Name',"spread_option")

SpreadOpt = 
  Spread with properties:

       OptionType: "put"
           Strike: 5
    ExerciseStyle: "european"
     ExerciseDate: 15-Sep-2021
             Name: "spread_option"

Create BlackScholes Model Object

Use finmodel to create a BlackScholes model object.

BlackScholesModel = finmodel("BlackScholes",'Volatility',[0.2,0.1])

BlackScholesModel = 
  BlackScholes with properties:

     Volatility: [0.2000 0.1000]
    Correlation: [2x2 double]

Create ratecurve Object

Create a flat ratecurve object using ratecurve.

Settle = datetime(2018,9,15);
Maturity = datetime(2023,9,15);
Rate = 0.035;
myRC = ratecurve('zero',Settle,Maturity,Rate,'Basis',12)

myRC = 
  ratecurve with properties:

                 Type: "zero"
          Compounding: -1
                Basis: 12
                Dates: 15-Sep-2023
                Rates: 0.0350
               Settle: 15-Sep-2018
         InterpMethod: "linear"
    ShortExtrapMethod: "next"
     LongExtrapMethod: "previous"

Create BjerksundStensland Pricer Object

Use finpricer to create a BjerksundStensland pricer object and use the ratecurve object for the 'DiscountCurve' name-value pair argument.

outPricer = finpricer("analytic",'Model',BlackScholesModel,'DiscountCurve',myRC,'SpotPrice',[100,105],'DividendValue',[0.09,0.17],'PricingMethod',"BjerksundStensland")

outPricer = 
  BjerksundStensland with properties:

    DiscountCurve: [1x1 ratecurve]
            Model: [1x1 finmodel.BlackScholes]
        SpotPrice: [100 105]
    DividendValue: [0.0900 0.1700]
     DividendType: "continuous"

Price Spread Instrument

Use price to compute the price and sensitivities for the Spread instrument.

[Price, outPR] = price(outPricer,SpreadOpt,["all"])

Price = 7.0596

outPR = 
  priceresult with properties:

       Results: [1x7 table]
    PricerData: []

outPR.Results

ans=1×7 table
    Price            Delta                    Gamma                   Lambda                Vega          Theta       Rho  
    ______    ____________________    ______________________    __________________    ________________    ______    _______

    7.0596    -0.23249     0.27057    0.0069887    0.0055319    -3.2932     3.8327    41.938    18.303    1.1011    -5.6943

Input Arguments

inpPricer — Pricer object

BjerksundStensland object | IkedaKunitomo object | Black object | BlackScholes object | CDSBlack object | ConzeViswanathan object | GoldmanSosinGatto object | HullWhite object | Heston object | KemnaVorst object | Kirk object | Levy object | Normal object | RollGeskeWhaley object | SABR object | TurnbullWakeman object

Pricer object (previously created using finpricer), specified as a scalar. The supported pricer objects are:

• BjerksundStensland

• IkedaKunitomo

• Black

• BlackScholes

• CDSBlack

• ConzeViswanathan

• GoldmanSosinGatto

• HullWhite

• Heston

• KemnaVorst

• Kirk

• Levy

• Normal

• RollGeskeWhaley

• SABR

• TurnbullWakeman

Data Types: object

inpInstrument — Instrument object

Cap object | Floor object | Swaption object | Vanilla object | Lookback object | Barrier object | DoubleBarrier object | Asian object | Spread object | VarianceSwap object | CDSOption object

Instrument object (previously created using fininstrument), specified as a scalar. The supported instrument objects are:

• Cap

• Floor

• Swaption

• Vanilla

• Lookback

• Barrier

• DoubleBarrier

• Asian

• Spread

• VarianceSwap

• CDSOption

Data Types: object

inpSensitivity — List of sensitivities to compute

[ ] (default) | string array of character vectors with values dependent on pricer object | cell array of character vectors with values dependent on pricer object

(Optional) List of sensitivities to compute, specified as a NOUT-by-1 or a 1-by-NOUT cell array of character vectors or string array.

The supported sensitivities depend on the pricing method.

inpPricer Object	Supported Sensitivities
BjerksundStensland	{'delta','gamma','vega', 'theta','rho','price','lambda'}
IkedaKunitomo	{'delta','gamma','vega','theta','rho','price','lambda'}
Black	'price'
BlackScholes	{'delta','gamma','vega','theta','rho','price','lambda'}
CDSBlack	'price'
ConzeViswanathan	{'delta','gamma','vega','theta','rho','price','lambda}'
GoldmanSosinGatto	{'delta','gamma','vega','theta','rho','price','lambda}'
HullWhite	'price'
Heston	'price'
KemnaVorst	{'delta','gamma','vega','theta','rho','price','lambda'}
Kirk	{'delta','gamma','vega','theta','rho','price','lambda'}
Levy	{'delta','gamma','vega','theta','rho','price','lambda'}
Normal	'price'
RollGeskeWhaley	{'delta','gamma','vega','theta','rho','price','lambda'}
SABR	'price'
TurnbullWakeman	{'delta','gamma','vega','theta','rho','price',}

inpSensitivity = {'All'} or inpSensitivity = ["All"] specifies that all sensitivities for the pricing method are returned. This is the same as specifying inpSensitivity to include each sensitivity.

Example: inpSensitivity = ["delta","gamma","vega","lambda","rho","theta","price"]

Data Types: cell | string

Output Arguments

Price — Instrument price

numeric

Instrument price, returned as a numeric.

PriceResult — Price result

PriceResult object

Price result, returned as a PriceResult object. The object has the following fields:

• PriceResult.Results — Table of results that includes sensitivities (if you specify inpSensitivity)

• PriceResult.PricerData — Structure for pricer data

  Note

  When pricing a VarianceSwap, PriceResult.FairVariance is returned.

Note

The inpPricer options that do not support sensitivities do not return a PriceResult. For example, there is no PriceResult returned for when using a Black, CDSBlack, HullWhite, Normal, Heston, or SABR pricing method.