# dbltouchbybls

Price double one-touch and double no-touch binary options using Black-Scholes option pricing model

Since R2019b

## Syntax

``Price = dbltouchbybls(RateSpec,StockSpec,Settle,Maturity,BarrierSpec,Barrier,Payoff)``

## Description

example

````Price = dbltouchbybls(RateSpec,StockSpec,Settle,Maturity,BarrierSpec,Barrier,Payoff)` calculates double one-touch and double no-touch binary options using Black-Scholes option pricing model. NoteAlternatively, you can use the `DoubleTouch` object to price double touch options. For more information, see Get Started with Workflows Using Object-Based Framework for Pricing Financial Instruments. ```

## Examples

collapse all

Compute the price of a double no-touch option using the following data:

```AssetPrice = 105; Rate = 0.1; Volatility = 0.2; Settle = datetime(2018,1,1); Maturity = datetime(2018,6,1);```

Define the `RateSpec` using `intenvset`.

```RateSpec = intenvset('ValuationDate', Settle, 'StartDates', Settle, 'EndDates', ... Maturity, 'Rates', Rate, 'Compounding', -1);```

Define the `StockSpec` using `stockspec`.

```DividendType = "Continuous"; DividendYield = Rate - 0.03; StockSpec = stockspec(Volatility, AssetPrice, DividendType, DividendYield);```

Calculate the price of a double no-touch binary option.

```BarrierSpec = "DNT"; Barrier = [120 80]; Payoff = 10; Price = dbltouchbybls(RateSpec, StockSpec, Settle, Maturity, BarrierSpec, Barrier, Payoff)```
```Price = 6.3082 ```

## Input Arguments

collapse all

Interest-rate term structure (annualized and continuously compounded), specified by the `RateSpec` obtained from `intenvset`. For information on the interest-rate specification, see `intenvset`.

Data Types: `struct`

Stock specification for the underlying asset, specified by the `StockSpec` obtained from `stockspec`.

`stockspec` handles several types of underlying assets. For example, for physical commodities, the price is `StockSpec.Asset`, the volatility is `StockSpec.Sigma`, and the convenience yield is `StockSpec.DividendAmounts`.

Data Types: `struct`

Settlement or trade date for the double touch option, specified as an `NINST`-by-`1` vector using a datetime array, string array, or date character vectors.

To support existing code, `dbltouchbybls` also accepts serial date numbers as inputs, but they are not recommended.

Maturity date for the double touch option, specified as an `NINST`-by-`1` vector using a datetime array, string array, or date character vectors.

To support existing code, `dbltouchbybls` also accepts serial date numbers as inputs, but they are not recommended.

Double barrier option type, specified as an `NINST`-by-`1` cell array of character vectors or string array with the following values:

• `'DOT'` — Double one-touch. The double one-touch option defines two `Barrier` levels. A double one-touch option provides a `Payoff` if the underlying asset ever touches either the upper or lower `Barrier` levels.

• `'DNT'` — Double no-touch. The double no-touch option defines two `Barrier` levels. A double no-touch option provides a `Payoff` if the underlying asset ever never touches either the upper or lower `Barrier` levels.

Data Types: `char` | `cell` | `string`

Double barrier value, specified as an `NINST`-by-`2` matrix of numeric values, where the first column is Upper Barrier(1)(UB) and the second column is Lower Barrier(2)(LB). Barrier(1) must be greater than Barrier(2).

Data Types: `double`

Payoff value, specified as an `NINST`-by-`1` matrix of numeric values, where each element is a `1`-by-`2` vector in which the first column is Barrier(1)(UB) and the second column is Barrier(2)(LB). Barrier(1) must be greater than Barrier(2).

Note

The payoff value is calculated for the point in time that the `Barrier` value is reached. The payoff is either cash or nothing. If you specify a double no-touch option using `BarrierSpec`, the payoff is at the `Maturity` of the option.

Data Types: `double`

## Output Arguments

collapse all

Expected prices for double one-touch options at time 0, returned as an `NINST`-by-`1` matrix.

A double one-touch or double no-touch option provides a payoff if the underlying spot either ever or never touches either the upper or lower `Barrier` levels. If neither barrier level is breached prior to expiration, the option expires worthless and the trader loses all the premium paid to the broker for setting up the trade. For example, if the current USD/EUR rate is 1.15, and the trader believes that this rate will change significantly over the next 15 days, the trader can use a double one-touch option with barriers at 1.10 and 1.20. The trader can profit if the rate moves beyond either of the two barriers.