/* * QUANTCONNECT.COM - Democratizing Finance, Empowering Individuals. * Lean Algorithmic Trading Engine v2.0. Copyright 2014 QuantConnect Corporation. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ using System; using MathNet.Numerics.Distributions; using Python.Runtime; using QuantConnect.Data; namespace QuantConnect.Indicators { /// /// Option Gamma indicator that calculate the gamma of an option /// /// derivative of option price change relative to $1 underlying changes public class Gamma : OptionGreeksIndicatorBase { /// /// Initializes a new instance of the Gamma class /// /// The name of this indicator /// The option to be tracked /// Risk-free rate model /// Dividend yield model /// The mirror option for parity calculation /// The option pricing model used to estimate Gamma /// The option pricing model used to estimate IV public Gamma(string name, Symbol option, IRiskFreeInterestRateModel riskFreeRateModel, IDividendYieldModel dividendYieldModel, Symbol mirrorOption = null, OptionPricingModelType? optionModel = null, OptionPricingModelType? ivModel = null) : base(name, option, riskFreeRateModel, dividendYieldModel, mirrorOption, optionModel, ivModel) { } /// /// Initializes a new instance of the Gamma class /// /// The option to be tracked /// Risk-free rate model /// Dividend yield model /// The mirror option for parity calculation /// The option pricing model used to estimate Gamma /// The option pricing model used to estimate IV public Gamma(Symbol option, IRiskFreeInterestRateModel riskFreeRateModel, IDividendYieldModel dividendYieldModel, Symbol mirrorOption = null, OptionPricingModelType? optionModel = null, OptionPricingModelType? ivModel = null) : this($"Gamma({option},{mirrorOption},{GetOptionModel(optionModel, option.ID.OptionStyle)})", option, riskFreeRateModel, dividendYieldModel, mirrorOption, optionModel, ivModel) { } /// /// Initializes a new instance of the Gamma class /// /// The name of this indicator /// The option to be tracked /// Risk-free rate model /// Dividend yield model /// The mirror option for parity calculation /// The option pricing model used to estimate Gamma /// The option pricing model used to estimate IV public Gamma(string name, Symbol option, PyObject riskFreeRateModel, PyObject dividendYieldModel, Symbol mirrorOption = null, OptionPricingModelType? optionModel = null, OptionPricingModelType? ivModel = null) : base(name, option, riskFreeRateModel, dividendYieldModel, mirrorOption, optionModel, ivModel) { } /// /// Initializes a new instance of the Gamma class /// /// The option to be tracked /// Risk-free rate model /// Dividend yield model /// The mirror option for parity calculation /// The option pricing model used to estimate Gamma /// The option pricing model used to estimate IV public Gamma(Symbol option, PyObject riskFreeRateModel, PyObject dividendYieldModel, Symbol mirrorOption = null, OptionPricingModelType? optionModel = null, OptionPricingModelType? ivModel = null) : this($"Gamma({option},{mirrorOption},{GetOptionModel(optionModel, option.ID.OptionStyle)})", option, riskFreeRateModel, dividendYieldModel, mirrorOption, optionModel, ivModel) { } /// /// Initializes a new instance of the Gamma class /// /// The name of this indicator /// The option to be tracked /// Risk-free rate model /// Dividend yield, as a constant /// The mirror option for parity calculation /// The option pricing model used to estimate Gamma /// The option pricing model used to estimate IV public Gamma(string name, Symbol option, IRiskFreeInterestRateModel riskFreeRateModel, decimal dividendYield = 0.0m, Symbol mirrorOption = null, OptionPricingModelType? optionModel = null, OptionPricingModelType? ivModel = null) : base(name, option, riskFreeRateModel, dividendYield, mirrorOption, optionModel, ivModel) { } /// /// Initializes a new instance of the Gamma class /// /// The option to be tracked /// Risk-free rate model /// Dividend yield, as a constant /// The mirror option for parity calculation /// The option pricing model used to estimate Gamma /// The option pricing model used to estimate IV public Gamma(Symbol option, IRiskFreeInterestRateModel riskFreeRateModel, decimal dividendYield = 0.0m, Symbol mirrorOption = null, OptionPricingModelType? optionModel = null, OptionPricingModelType? ivModel = null) : this($"Gamma({option},{mirrorOption},{GetOptionModel(optionModel, option.ID.OptionStyle)})", option, riskFreeRateModel, dividendYield, mirrorOption, optionModel, ivModel) { } /// /// Initializes a new instance of the Gamma class /// /// The name of this indicator /// The option to be tracked /// Risk-free rate model /// Dividend yield, as a constant /// The mirror option for parity calculation /// The option pricing model used to estimate Gamma /// The option pricing model used to estimate IV public Gamma(string name, Symbol option, PyObject riskFreeRateModel, decimal dividendYield = 0.0m, Symbol mirrorOption = null, OptionPricingModelType? optionModel = null, OptionPricingModelType? ivModel = null) : base(name, option, riskFreeRateModel, dividendYield, mirrorOption, optionModel, ivModel) { } /// /// Initializes a new instance of the Gamma class /// /// The option to be tracked /// Risk-free rate model /// Dividend yield, as a constant /// The mirror option for parity calculation /// The option pricing model used to estimate Gamma /// The option pricing model used to estimate IV public Gamma(Symbol option, PyObject riskFreeRateModel, decimal dividendYield = 0.0m, Symbol mirrorOption = null, OptionPricingModelType? optionModel = null, OptionPricingModelType? ivModel = null) : this($"Gamma({option},{mirrorOption},{GetOptionModel(optionModel, option.ID.OptionStyle)})", option, riskFreeRateModel, dividendYield, mirrorOption, optionModel, ivModel) { } /// /// Initializes a new instance of the Gamma class /// /// The name of this indicator /// The option to be trackedam> /// Risk-free rate, as a constant /// Dividend yield, as a constant /// The mirror option for parity calculation /// The option pricing model used to estimate Gamma /// The option pricing model used to estimate IV public Gamma(string name, Symbol option, decimal riskFreeRate = 0.05m, decimal dividendYield = 0.0m, Symbol mirrorOption = null, OptionPricingModelType? optionModel = null, OptionPricingModelType? ivModel = null) : base(name, option, riskFreeRate, dividendYield, mirrorOption, optionModel, ivModel) { } /// /// Initializes a new instance of the Gamma class /// /// The option to be tracked /// Risk-free rate, as a constant /// Dividend yield, as a constant /// The mirror option for parity calculation /// The option pricing model used to estimate Gamma /// The option pricing model used to estimate IV public Gamma(Symbol option, decimal riskFreeRate = 0.05m, decimal dividendYield = 0.0m, Symbol mirrorOption = null, OptionPricingModelType? optionModel = null, OptionPricingModelType? ivModel = null) : this($"Gamma({option},{mirrorOption},{GetOptionModel(optionModel, option.ID.OptionStyle)})", option, riskFreeRate, dividendYield, mirrorOption, optionModel, ivModel) { } /// /// Calculate the Gamma of the option /// protected override decimal CalculateGreek(decimal timeTillExpiry) { var underlyingPrice = (double)UnderlyingPrice.Current.Value; var strike = (double)Strike; var timeTillExpiryDouble = (double)timeTillExpiry; var riskFreeRate = (double)RiskFreeRate.Current.Value; var dividendYield = (double)DividendYield.Current.Value; var iv = (double)ImpliedVolatility.Current.Value; double result; switch (_optionModel) { case OptionPricingModelType.BlackScholes: var norm = new Normal(); var d1 = OptionGreekIndicatorsHelper.CalculateD1(underlyingPrice, strike, timeTillExpiryDouble, riskFreeRate, dividendYield, iv); // allow at least 1% IV result = norm.Density(-d1) / underlyingPrice / Math.Max(iv, 0.01) / Math.Sqrt(timeTillExpiryDouble); break; case OptionPricingModelType.BinomialCoxRossRubinstein: case OptionPricingModelType.ForwardTree: var upFactor = Math.Exp(iv * Math.Sqrt(timeTillExpiryDouble / OptionGreekIndicatorsHelper.Steps)); if (upFactor == 1) { // provide a small step to estimate gamma upFactor = 1.0001; } // Finite differencing approach var sU = underlyingPrice * upFactor * upFactor; var sD = underlyingPrice / upFactor / upFactor; var fU = 0d; var fM = 0d; var fD = 0d; if (_optionModel == OptionPricingModelType.BinomialCoxRossRubinstein) { fU = OptionGreekIndicatorsHelper.CRRTheoreticalPrice(iv, sU, strike, timeTillExpiryDouble, riskFreeRate, dividendYield, Right); fM = OptionGreekIndicatorsHelper.CRRTheoreticalPrice(iv, underlyingPrice, strike, timeTillExpiryDouble, riskFreeRate, dividendYield, Right); fD = OptionGreekIndicatorsHelper.CRRTheoreticalPrice(iv, sD, strike, timeTillExpiryDouble, riskFreeRate, dividendYield, Right); } else if (_optionModel == OptionPricingModelType.ForwardTree) { fU = OptionGreekIndicatorsHelper.ForwardTreeTheoreticalPrice(iv, sU, strike, timeTillExpiryDouble, riskFreeRate, dividendYield, Right); fM = OptionGreekIndicatorsHelper.ForwardTreeTheoreticalPrice(iv, underlyingPrice, strike, timeTillExpiryDouble, riskFreeRate, dividendYield, Right); fD = OptionGreekIndicatorsHelper.ForwardTreeTheoreticalPrice(iv, sD, strike, timeTillExpiryDouble, riskFreeRate, dividendYield, Right); } var gammaU = (fU - fM) / (sU - underlyingPrice); var gammaD = (fM - fD) / (underlyingPrice - sD); result = OptionGreekIndicatorsHelper.Divide((gammaU - gammaD) * 2, sU - sD); break; default: throw new Exception("Unrecognized Option Pricing Model"); } return Convert.ToDecimal(result); } } }