sp_OptionPLMatrix
Updated 2023-11-17 15:31:18.937000
Syntax
DECLARE @CallPut nvarchar(4000);
DECLARE @AssetPrice float;
DECLARE @StrikePrice float;
DECLARE @TimeToMaturity float;
DECLARE @RiskFreeRate float;
DECLARE @DividendRate float;
DECLARE @Volatility float;
DECLARE @AmEur nvarchar(4000);
DECLARE @Row nvarchar(4000);
DECLARE @RowStep float;
DECLARE @RowNumSteps int;
DECLARE @Col nvarchar(4000);
DECLARE @ColStep float;
DECLARE @ColNumSteps int;
DECLARE @Notional float;
DECLARE @Decimals int;
-- TODO: Set parameter values here.
EXECUTE [westclintech].[wct].[sp_OptionPLMatrix]
@CallPut
,@AssetPrice
,@StrikePrice
,@TimeToMaturity
,@RiskFreeRate
,@DividendRate
,@Volatility
,@AmEur
,@Row
,@RowStep
,@RowNumSteps
,@Col
,@ColStep
,@ColNumSteps
,@Notional
,@Decimals
Description
Use the stored procedure sp_OptionPLMatrix to generate a result set of profit (loss) by varying two inputs into the theoretical value of the option. For example, you could generate a result set that shows the profit (loss) based on changes in the price of the underlying asset and the volatility. This stored procedure calls the table-valued function OPTIONPLMATRIX and formats the output into a matrix.
Arguments
@Decimals
Identifies the number of decimal places in the returned values. @Decimal is an expression of type int or of a type that can be implicitly converted to int.
@RowNumSteps
identifies the number of times that the initial row value is incremented and/or decremented. @RowNumSteps is an expression of type int or of a type that can be implicitly converted to int.
@DividendRate
the annualized, continuously compounded dividend rate over the life of the option. For currency options, @DividendRate should be the foreign risk-free interest rate. @DividendRate is an expression of type float or of a type that can be implicitly converted to float.
@ColNumSteps
Identifies the number of times that the initial column value is incremented and/or decremented. @ColNumSteps is an expression of type int or of a type that can be implicitly converted to int.
@Notional
Identifies the notional value of the option position. @Notional is an expression of type float or of a type that can be implicitly converted to float.
@RiskFreeRate
the annualized, continuously compounded risk-free rate of return over the life of the option. @RiskFreeRate is an expression of type float or of a type that can be implicitly converted to float.
@TimeToMaturity
the time to expiration of the option, expressed in years. @TimeToMaturity is an expression of type float or of a type that can be implicitly converted to float.
@ColStep
Identifies the value by which the intial column value is incremented and/or decremented. In the case of time ('T') the row values are only decremented and the step value is assumed to be expressed in days. @ColStep is an expression of type float or of a type that can be implicitly converted to float.
@RowStep
identifies the value by which the intial row value is incremented and/or decremented. In the case of time ('T') the row values are only decremented and the step value is assumed to be expressed in days. @RowStep is an expression of type float or of a type that can be implicitly converted to float.
@AmEur
identifies the option as being American ('A') or European ('E'). @AmEur is an expression of type nvarchar or of a type that can be implicitly converted to nvarchar.
@CallPut
identifies the option as being a call ('C') or a put ('P'). @CallPut is an expression of type nvarchar or of a type that can be implicitly converted to nvarchar.
@Row
identifies the variable which is changing with each row. @Row is an expression of type nvarchar or of a type that can be implicitly converted to nvarchar. The following values may be passed into @Row:
{
"columns": [
{
"field": "column 1"
}
],
"rows": [
{
"column 1": "'S' , 'U' , 'ASSETP' , 'UNDERLYING'"
},
{
"column 1": "'X' , 'K' , 'STRIKE'"
},
{
"column 1": "'T' , 'TIME'"
},
{
"column 1": "'R' , 'RF' , 'RISKFREE'"
},
{
"column 1": "'D' , 'DIV' , 'DIVIDEND'"
},
{
"column 1": "'V' , 'VOL' , 'VOLATILITY' , 'SIGMA'"
}
]
}
@StrikePrice
the exercise price of the option. @StrikePrice is an expression of type float or of a type that can be implicitly converted to float.
@Col
Identifies the variable which is changing with each column. @Col is an expression of type nvarchar or of a type that can be implicitly converted to nvarchar. The following values may be passed into @Col:
{
"columns": [
{
"field": "column 1"
}
],
"rows": [
{
"column 1": "'S' , 'U' , 'ASSETP' , 'UNDERLYING'"
},
{
"column 1": "'X' , 'K' , 'STRIKE'"
},
{
"column 1": "'T' , 'TIME'"
},
{
"column 1": "'R' , 'RF' , 'RISKFREE'"
},
{
"column 1": "'D' , 'DIV' , 'DIVIDEND'"
},
{
"column 1": "'V' , 'VOL' , 'VOLATILITY' , 'SIGMA'"
}
]
}
@Volatility
the volatility of the relative price change of the underlying asset. @Volatility is an expression of type float or of a type that can be implicitly converted to float.
@AssetPrice
the price of the underlying asset. @AssetPrice is an expression of type float or of a type that can be implicitly converted to float.
Return Type
int
Remarks
@Volatility must be greater than zero (@Volatility > 0).
@TimeToMaturity must be greater than zero (@TimeToMaturity > 0).
@AssetPrice must be greater than zero (@AssetPrice > 0).
@StrikePrice must be greater than zero (@StrikePrice > 0).
If @ReturnValue is NULL, then @ReturnValue is set to 'P'.
If @DividendRate is NULL an error will be returned.
If @RiskFreeRate is NULL an error will be returned.
@RowNumSteps must be greater than zero.
@ColNumSteps must be greater than zero.
European options are calculated using Black-Scholes-Merton.
American options are calculated using Bjerksund & Stensland 2002.
@Row cannot be the same as @Col
Results are returned so that the lower left cell of the matrix has the smallest profit (biggest loss) and the upper right cell of the matrix has greatest profit (smallest loss) and the center cell has a profit of zero.
Return Code Values: 0 (success) or 100 (failure).
Examples
In this example, we are going to calculate how the changes in the underlying and volatility will affect the profit on a Call option where the underlying is valued at 105, the strike price is 100, the option expires on 2013-06-21 and today’s date is 2012-09-04. The continuously compounded risk free rate is 2% and the continuously compounded dividend rate is 1.25%. The volatility is 20%. We want the rows to move the underlying 3 steps in increments of 0.5 and the columns to move the volatility in 2 steps in increments of 0.01. This means that we will calculate new price values where the underlying prices are 103.5, 104.0, 104.5, 105.0, 105.5, 106 and 106.5 and where the volatilities are .18, .19, .20, .21 and .22. The notional amount is 1,000,000 and we want the results returned to 2 decimal places.
DECLARE @CallPut nvarchar(4000) = 'C';
DECLARE @AssetP float = 105;
DECLARE @Strike float = 100;
DECLARE @Time float = datediff(d, '2012-09-04', '2013-06-21') / cast(365 as float)
;
DECLARE @RiskFree float = .02;
DECLARE @Div float = .0125;
DECLARE @Vol float = .20;
DECLARE @AmEur nvarchar(4000) = 'E';
DECLARE @Row nvarchar(4000) = 'UNDERLYING';
DECLARE @RowStep float = .50;
DECLARE @RowNumSteps int = 3;
DECLARE @Col nvarchar(4000) = 'VOL';
DECLARE @ColStep float = .01;
DECLARE @ColNumSteps int = 2;
DECLARE @Notional float = 1000000;
DECLARE @Decimals int = 2;
EXECUTE wct.sp_OptionPLMatrix @CallPut,
@AssetP,
@Strike,
@Time,
@RiskFree,
@Div,
@Vol,
@AmEur,
@Row,
@RowStep,
@RowNumSteps,
@Col,
@ColStep,
@ColNumSteps,
@Notional,
@Decimals;
This produces the following result.
{"columns":[{"field":"UNDERLYING","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"0.18","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"0.19","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"0.20","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"0.21","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"},{"field":"0.22","headerClass":"ag-right-aligned-header","cellClass":"ag-right-aligned-cell"}],"rows":[{"UNDERLYING":"106.5","0.18":"328563.51","0.19":"659375.49","0.20":"992966.46","0.21":"1328933.28","0.22":"1666940.59"},{"UNDERLYING":"106","0.18":"-12912.2","0.19":"320949.6","0.20":"657228.13","0.21":"995567.13","0.22":"1335670.64"},{"UNDERLYING":"105.5","0.18":"-349214.84","0.19":"-12536.86","0.20":"326213.44","0.21":"666725.09","0.22":"1008739.96"},{"UNDERLYING":"105","0.18":"-680248.06","0.19":"-340997.78","0.20":"0","0.21":"342477.54","0.22":"686212.79"},{"UNDERLYING":"104.5","0.18":"-1005917.97","0.19":"-664349.1","0.20":"-321336.41","0.21":"22893.31","0.22":"368152.03"},{"UNDERLYING":"104","0.18":"-1326133.33","0.19":"-982509.08","0.20":"-637721.96","0.21":"-291960.47","0.22":"54619.09"},{"UNDERLYING":"103.5","0.18":"-1640805.87","0.19":"-1295398.5","0.20":"-949085","0.21":"-602018.54","0.22":"-254326.2"}]}
Remember, that this is a stored procedure and in T-SQL the inputs to the stored procedure are not evaluated. So, if we had used the following syntax,
EXECUTE wct.sp_OptionPLMatrix
'C'
,105
,100
,datediff(d,'2012-09-04','2013-06-21')/cast(365 as float)
,.02
,.0125
,.20
,'E'
,'UNDERLYING'
,.50
,3
,'VOL'
,.01
,2
,1000000
,2;
SQL Server will generate an error message. We could, however, have entered
EXECUTE wct.sp_OptionPLMatrix 'C',
105,
100,
0.794520547945205,
.02,
.0125,
.20,
'E',
'UNDERLYING',
.50,
3,
'VOL',
.01,
2,
1000000,
2;
and the stored procedure would have executed and returned the results as above.