/* * 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 System.Collections.Generic; using Python.Runtime; using QuantConnect.Data.UniverseSelection; using QuantConnect.Interfaces; using QuantConnect.Securities; namespace QuantConnect.Algorithm.Framework.Selection { /// /// Provides an implementation of that subscribes to option chains /// public class OptionUniverseSelectionModel : UniverseSelectionModel { private DateTime _nextRefreshTimeUtc; private readonly TimeSpan _refreshInterval; private readonly UniverseSettings _universeSettings; private readonly Func> _optionChainSymbolSelector; /// /// Gets the next time the framework should invoke the `CreateUniverses` method to refresh the set of universes. /// public override DateTime GetNextRefreshTimeUtc() => _nextRefreshTimeUtc; /// /// Creates a new instance of /// /// Time interval between universe refreshes /// Selects symbols from the provided option chain public OptionUniverseSelectionModel(TimeSpan refreshInterval, Func> optionChainSymbolSelector) : this(refreshInterval, optionChainSymbolSelector, null) { } /// /// Creates a new instance of /// /// Time interval between universe refreshes /// Selects symbols from the provided option chain public OptionUniverseSelectionModel(TimeSpan refreshInterval, PyObject optionChainSymbolSelector) : this(refreshInterval, optionChainSymbolSelector.ConvertToDelegate>>(), null) { } /// /// Creates a new instance of /// /// Time interval between universe refreshes /// Selects symbols from the provided option chain /// Universe settings define attributes of created subscriptions, such as their resolution and the minimum time in universe before they can be removed public OptionUniverseSelectionModel(TimeSpan refreshInterval, PyObject optionChainSymbolSelector, UniverseSettings universeSettings) : this(refreshInterval, optionChainSymbolSelector.ConvertToDelegate>>(), universeSettings) { } /// /// Creates a new instance of /// /// Time interval between universe refreshes /// Selects symbols from the provided option chain /// Universe settings define attributes of created subscriptions, such as their resolution and the minimum time in universe before they can be removed public OptionUniverseSelectionModel( TimeSpan refreshInterval, Func> optionChainSymbolSelector, UniverseSettings universeSettings ) { _nextRefreshTimeUtc = DateTime.MinValue; _refreshInterval = refreshInterval; _universeSettings = universeSettings; _optionChainSymbolSelector = optionChainSymbolSelector; } /// /// Creates the universes for this algorithm. Called once after /// /// The algorithm instance to create universes for /// The universes to be used by the algorithm public override IEnumerable CreateUniverses(QCAlgorithm algorithm) { _nextRefreshTimeUtc = algorithm.UtcTime + _refreshInterval; var uniqueUnderlyingSymbols = new HashSet(); foreach (var optionSymbol in _optionChainSymbolSelector(algorithm.UtcTime)) { if (!optionSymbol.SecurityType.IsOption()) { throw new ArgumentException("optionChainSymbolSelector must return option, index options, or futures options symbols."); } // prevent creating duplicate option chains -- one per underlying if (uniqueUnderlyingSymbols.Add(optionSymbol.Underlying)) { yield return algorithm.CreateOptionChain(optionSymbol, Filter, _universeSettings); } } } /// /// Defines the option chain universe filter /// protected virtual OptionFilterUniverse Filter(OptionFilterUniverse filter) { // NOP return filter; } } }