# 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. from clr import AddReference from clr import GetClrType as typeof AddReference("System") AddReference("QuantConnect.Common") AddReference("QuantConnect.Algorithm.Framework") from QuantConnect import * from QuantConnect.Securities import * from QuantConnect.Data.Auxiliary import ZipEntryName from QuantConnect.Data.UniverseSelection import FuturesChainUniverse from Selection.UniverseSelectionModel import UniverseSelectionModel from datetime import datetime class FutureUniverseSelectionModel(UniverseSelectionModel): '''Provides an implementation of IUniverseSelectionMode that subscribes to future chains''' def __init__(self, refreshInterval, futureChainSymbolSelector, universeSettings = None, securityInitializer = None): '''Creates a new instance of FutureUniverseSelectionModel Args: refreshInterval: Time interval between universe refreshes futureChainSymbolSelector: Selects symbols from the provided future chain universeSettings: Universe settings define attributes of created subscriptions, such as their resolution and the minimum time in universe before they can be removed securityInitializer: [Obsolete, will not be used] Performs extra initialization (such as setting models) after we create a new security object''' self.nextRefreshTimeUtc = datetime.min self.refreshInterval = refreshInterval self.futureChainSymbolSelector = futureChainSymbolSelector self.universeSettings = universeSettings self.securityInitializer = securityInitializer def GetNextRefreshTimeUtc(self): '''Gets the next time the framework should invoke the `CreateUniverses` method to refresh the set of universes.''' return self.nextRefreshTimeUtc def CreateUniverses(self, algorithm): '''Creates a new fundamental universe using this class's selection functions Args: algorithm: The algorithm instance to create universes for Returns: The universe defined by this model''' self.nextRefreshTimeUtc = algorithm.UtcTime + self.refreshInterval uniqueSymbols = set() for futureSymbol in self.futureChainSymbolSelector(algorithm.UtcTime): if futureSymbol.SecurityType != SecurityType.Future: raise ValueError("futureChainSymbolSelector must return future symbols.") # prevent creating duplicate future chains -- one per symbol if futureSymbol not in uniqueSymbols: uniqueSymbols.add(futureSymbol) yield self.CreateFutureChain(algorithm, futureSymbol) def CreateFutureChain(self, algorithm, symbol): '''Creates a FuturesChainUniverse for a given symbol Args: algorithm: The algorithm instance to create universes for symbol: Symbol of the future Returns: FuturesChainUniverse for the given symbol''' if symbol.SecurityType != SecurityType.Future: raise ValueError("CreateFutureChain requires an future symbol.") # rewrite non-canonical symbols to be canonical market = symbol.ID.Market if not symbol.IsCanonical(): symbol = Symbol.Create(symbol.Value, SecurityType.Future, market, f"/{symbol.Value}") # resolve defaults if not specified settings = self.universeSettings if self.universeSettings is not None else algorithm.UniverseSettings initializer = self.securityInitializer if self.securityInitializer is not None else algorithm.SecurityInitializer # create canonical security object, but don't duplicate if it already exists securities = [s for s in algorithm.Securities if s.Key == symbol] if len(securities) == 0: futureChain = self.CreateFutureChainSecurity(algorithm, symbol, settings, initializer) else: futureChain = securities[0] # set the future chain contract filter function futureChain.SetFilter(self.Filter) # force future chain security to not be directly tradable AFTER it's configured to ensure it's not overwritten futureChain.IsTradable = False return FuturesChainUniverse(futureChain, settings, algorithm.SubscriptionManager, initializer) def CreateFutureChainSecurity(self, algorithm, symbol, settings, initializer): '''Creates the canonical Future chain security for a given symbol Args: algorithm: The algorithm instance to create universes for symbol: Symbol of the future settings: Universe settings define attributes of created subscriptions, such as their resolution and the minimum time in universe before they can be removed initializer: [Obsolete, will not be used] Performs extra initialization (such as setting models) after we create a new security object Returns Future for the given symbol''' config = algorithm.SubscriptionManager.SubscriptionDataConfigService.Add(typeof(ZipEntryName), symbol, settings.Resolution, settings.FillForward, settings.ExtendedMarketHours, False) return algorithm.Securities.CreateSecurity(symbol, config, settings.Leverage, False) def Filter(self, filter): '''Defines the future chain universe filter''' # NOP return filter