/* * 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.Collections.Generic; using System.Linq; using QuantConnect.Data; using QuantConnect.Data.Consolidators; using QuantConnect.Data.UniverseSelection; using QuantConnect.Indicators; using QuantConnect.Securities; namespace QuantConnect.Algorithm.Framework.Alphas { /// /// Defines a custom alpha model that uses MACD crossovers. The MACD signal line is /// used to generate up/down insights if it's stronger than the bounce threshold. /// If the MACD signal is within the bounce threshold then a flat price insight is returned. /// public class MacdAlphaModel : AlphaModel { private readonly int _fastPeriod; private readonly int _slowPeriod; private readonly int _signalPeriod; private readonly MovingAverageType _movingAverageType; private readonly Resolution _resolution; private const decimal BounceThresholdPercent = 0.01m; private InsightCollection _insightCollection = new(); /// /// Dictionary containing basic information for each symbol present as key /// protected Dictionary _symbolData { get; init; } /// /// Initializes a new instance of the class /// /// The MACD fast period /// The MACD slow period /// The smoothing period for the MACD signal /// The type of moving average to use in the MACD /// The resolution of data sent into the MACD indicator public MacdAlphaModel( int fastPeriod = 12, int slowPeriod = 26, int signalPeriod = 9, MovingAverageType movingAverageType = MovingAverageType.Exponential, Resolution resolution = Resolution.Daily ) { _fastPeriod = fastPeriod; _slowPeriod = slowPeriod; _signalPeriod = signalPeriod; _movingAverageType = movingAverageType; _resolution = resolution; _symbolData = new Dictionary(); Name = $"{nameof(MacdAlphaModel)}({fastPeriod},{slowPeriod},{signalPeriod},{movingAverageType},{resolution})"; } /// /// Determines an insight for each security based on it's current MACD signal /// /// The algorithm instance /// The new data available /// The new insights generated public override IEnumerable Update(QCAlgorithm algorithm, Slice data) { foreach (var sd in _symbolData.Values) { if (sd.Security.Price == 0) { continue; } var direction = InsightDirection.Flat; var normalizedSignal = sd.MACD.Signal / sd.Security.Price; if (normalizedSignal > BounceThresholdPercent) { direction = InsightDirection.Up; } else if (normalizedSignal < -BounceThresholdPercent) { direction = InsightDirection.Down; } // ignore signal for same direction as previous signal if (direction == sd.PreviousDirection) { continue; } sd.PreviousDirection = direction; if (direction == InsightDirection.Flat) { CancelInsights(algorithm, sd.Security.Symbol); continue; } var insightPeriod = _resolution.ToTimeSpan().Multiply(_fastPeriod); var insight = Insight.Price(sd.Security.Symbol, insightPeriod, direction); _insightCollection.Add(insight); yield return insight; } } /// /// Event fired each time the we add/remove securities from the data feed. /// This initializes the MACD for each added security and cleans up the indicator for each removed security. /// /// The algorithm instance that experienced the change in securities /// The security additions and removals from the algorithm public override void OnSecuritiesChanged(QCAlgorithm algorithm, SecurityChanges changes) { foreach (var added in changes.AddedSecurities) { if (_symbolData.ContainsKey(added.Symbol)) { continue; } _symbolData.Add(added.Symbol, new SymbolData(algorithm, added, _fastPeriod, _slowPeriod, _signalPeriod, _movingAverageType, _resolution)); } foreach (var removed in changes.RemovedSecurities) { var symbol = removed.Symbol; SymbolData data; if (_symbolData.TryGetValue(symbol, out data)) { // clean up our consolidator algorithm.SubscriptionManager.RemoveConsolidator(symbol, data.Consolidator); _symbolData.Remove(symbol); } // remove from insight collection manager CancelInsights(algorithm, symbol); } } private void CancelInsights(QCAlgorithm algorithm, Symbol symbol) { if (_insightCollection.TryGetValue(symbol, out var insights)) { algorithm.Insights.Cancel(insights); _insightCollection.Clear(new[] { symbol }); } } /// /// Class representing basic data of a symbol /// public class SymbolData { /// /// Previous direction property /// public InsightDirection? PreviousDirection { get; set; } /// /// Security of the Symbol Data /// public Security Security { get; init; } /// /// Consolidator property /// public IDataConsolidator Consolidator { get; init; } /// /// Moving Average Convergence Divergence indicator /// public MovingAverageConvergenceDivergence MACD { get; init; } /// /// Initializes an instance of the SymbolData class with the given arguments /// public SymbolData(QCAlgorithm algorithm, Security security, int fastPeriod, int slowPeriod, int signalPeriod, MovingAverageType movingAverageType, Resolution resolution) { Security = security; Consolidator = algorithm.ResolveConsolidator(security.Symbol, resolution); algorithm.SubscriptionManager.AddConsolidator(security.Symbol, Consolidator); MACD = new MovingAverageConvergenceDivergence(fastPeriod, slowPeriod, signalPeriod, movingAverageType); algorithm.RegisterIndicator(security.Symbol, MACD, Consolidator); algorithm.WarmUpIndicator(security.Symbol, MACD, resolution); } } } }