/* * 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 System.Linq; using NodaTime; using QuantConnect.Data; using QuantConnect.Data.Market; using QuantConnect.Interfaces; using QuantConnect.Securities; namespace QuantConnect.Algorithm { public partial class QCAlgorithm { /// /// Gets or sets the history provider for the algorithm /// public IHistoryProvider HistoryProvider { get; set; } /// /// Gets whether or not this algorithm is still warming up /// public bool IsWarmingUp { get; private set; } /// /// Sets the warm up period to the specified value /// /// The amount of time to warm up, this does not take into account market hours/weekends public void SetWarmup(TimeSpan timeSpan) { _warmupBarCount = null; _warmupTimeSpan = timeSpan; } /// /// Sets the warm up period by resolving a start date that would send that amount of data into /// the algorithm. The highest (smallest) resolution in the securities collection will be used. /// For example, if an algorithm has minute and daily data and 200 bars are requested, that would /// use 200 minute bars. /// /// The number of data points requested for warm up public void SetWarmup(int barCount) { _warmupTimeSpan = null; _warmupBarCount = barCount; } /// /// Sets to false to indicate this algorithm has finished its warm up /// public void SetFinishedWarmingUp() { IsWarmingUp = false; } /// /// Gets the history requests required for provide warm up data for the algorithm /// /// public IEnumerable GetWarmupHistoryRequests() { if (_warmupBarCount.HasValue) { return CreateBarCountHistoryRequests(Securities.Keys, _warmupBarCount.Value); } if (_warmupTimeSpan.HasValue) { var end = UtcTime.ConvertFromUtc(TimeZone); return CreateDateRangeHistoryRequests(Securities.Keys, end - _warmupTimeSpan.Value, end); } // if not warmup requested return nothing return Enumerable.Empty(); } /// /// Get the history for all configured securities over the requested span. /// This will use the resolution and other subscription settings for each security. /// The symbols must exist in the Securities collection. /// /// The span over which to request data. This is a calendar span, so take into consideration weekends and such /// The resolution to request /// An enumerable of slice containing data over the most recent span for all configured securities public IEnumerable History(TimeSpan span, Resolution? resolution = null) { return History(Securities.Keys, Time - span, Time, resolution); } /// /// Get the history for all configured securities over the requested span. /// This will use the resolution and other subscription settings for each security. /// The symbols must exist in the Securities collection. /// /// The number of bars to request /// The resolution to request /// An enumerable of slice containing data over the most recent span for all configured securities public IEnumerable History(int periods, Resolution? resolution = null) { return History(Securities.Keys, periods, resolution); } /// /// Gets the historical data for all symbols of the requested type over the requested span. /// The symbol's configured values for resolution and fill forward behavior will be used /// The symbols must exist in the Securities collection. /// /// The span over which to retrieve recent historical data /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable> History(TimeSpan span, Resolution? resolution = null) where T : BaseData { return History(Securities.Keys, span, resolution); } /// /// Gets the historical data for the specified symbols over the requested span. /// The symbols must exist in the Securities collection. /// /// The data type of the symbols /// The symbols to retrieve historical data for /// The span over which to retrieve recent historical data /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable> History(IEnumerable symbols, TimeSpan span, Resolution? resolution = null) where T : BaseData { return History(symbols, Time - span, Time, resolution); } /// /// Gets the historical data for the specified symbols. The exact number of bars will be returned for /// each symbol. This may result in some data start earlier/later than others due to when various /// exchanges are open. The symbols must exist in the Securities collection. /// /// The data type of the symbols /// The symbols to retrieve historical data for /// The number of bars to request /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable> History(IEnumerable symbols, int periods, Resolution? resolution = null) where T : BaseData { var requests = symbols.Select(x => { var security = Securities[x]; // don't make requests for symbols of the wrong type if (!typeof(T).IsAssignableFrom(security.SubscriptionDataConfig.Type)) return null; Resolution? res = resolution ?? security.Resolution; var start = GetStartTimeAlgoTz(x, periods, resolution).ConvertToUtc(TimeZone); return CreateHistoryRequest(security, start, UtcTime.RoundDown(res.Value.ToTimeSpan()), resolution); }); return History(requests.Where(x => x != null)).Get(); } /// /// Gets the historical data for the specified symbols between the specified dates. The symbols must exist in the Securities collection. /// /// The data type of the symbols /// The symbols to retrieve historical data for /// The start time in the algorithm's time zone /// The end time in the algorithm's time zone /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable> History(IEnumerable symbols, DateTime start, DateTime end, Resolution? resolution = null) where T : BaseData { var requests = symbols.Select(x => { var security = Securities[x]; // don't make requests for symbols of the wrong type if (!typeof (T).IsAssignableFrom(security.SubscriptionDataConfig.Type)) return null; return CreateHistoryRequest(security, start, end, resolution); }); return History(requests.Where(x => x != null)).Get(); } /// /// Gets the historical data for the specified symbol over the request span. The symbol must exist in the Securities collection. /// /// The data type of the symbol /// The symbol to retrieve historical data for /// The span over which to retrieve recent historical data /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable History(Symbol symbol, TimeSpan span, Resolution? resolution = null) where T : BaseData { return History(symbol, Time - span, Time, resolution); } /// /// Gets the historical data for the specified symbol. The exact number of bars will be returned. /// The symbol must exist in the Securities collection. /// /// The symbol to retrieve historical data for /// The number of bars to request /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable History(Symbol symbol, int periods, Resolution? resolution = null) { var security = Securities[symbol]; var start = GetStartTimeAlgoTz(symbol, periods, resolution); return History(new[] {symbol}, start, Time.RoundDown((resolution ?? security.Resolution).ToTimeSpan()), resolution).Get(symbol); } /// /// Gets the historical data for the specified symbol. The exact number of bars will be returned. /// The symbol must exist in the Securities collection. /// /// The data type of the symbol /// The symbol to retrieve historical data for /// The number of bars to request /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable History(Symbol symbol, int periods, Resolution? resolution = null) where T : BaseData { if (resolution == Resolution.Tick) throw new ArgumentException("History functions that accept a 'periods' parameter can not be used with Resolution.Tick"); var security = Securities[symbol]; // verify the types match var actualType = security.SubscriptionDataConfig.Type; var requestedType = typeof(T); if (!requestedType.IsAssignableFrom(actualType)) { throw new ArgumentException("The specified security is not of the requested type. Symbol: " + symbol + " Requested Type: " + requestedType.Name + " Actual Type: " + actualType); } var start = GetStartTimeAlgoTz(symbol, periods, resolution); return History(symbol, start, Time.RoundDown((resolution ?? security.Resolution).ToTimeSpan()), resolution); } /// /// Gets the historical data for the specified symbol between the specified dates. The symbol must exist in the Securities collection. /// /// The symbol to retrieve historical data for /// The start time in the algorithm's time zone /// The end time in the algorithm's time zone /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable History(Symbol symbol, DateTime start, DateTime end, Resolution? resolution = null) where T : BaseData { var security = Securities[symbol]; // verify the types match var actualType = security.SubscriptionDataConfig.Type; var requestedType = typeof(T); if (!requestedType.IsAssignableFrom(actualType)) { throw new ArgumentException("The specified security is not of the requested type. Symbol: " + symbol + " Requested Type: " + requestedType.Name + " Actual Type: " + actualType); } var request = CreateHistoryRequest(security, start, end, resolution); return History(request).Get(symbol); } /// /// Gets the historical data for the specified symbol over the request span. The symbol must exist in the Securities collection. /// /// The symbol to retrieve historical data for /// The span over which to retrieve recent historical data /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable History(Symbol symbol, TimeSpan span, Resolution? resolution = null) { return History(new[] {symbol}, span, resolution).Get(symbol); } /// /// Gets the historical data for the specified symbol over the request span. The symbol must exist in the Securities collection. /// /// The symbol to retrieve historical data for /// The start time in the algorithm's time zone /// The end time in the algorithm's time zone /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable History(Symbol symbol, DateTime start, DateTime end, Resolution? resolution = null) { return History(new[] {symbol}, start, end, resolution).Get(symbol); } /// /// Gets the historical data for the specified symbols over the requested span. /// The symbol's configured values for resolution and fill forward behavior will be used /// The symbols must exist in the Securities collection. /// /// The symbols to retrieve historical data for /// The span over which to retrieve recent historical data /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable History(IEnumerable symbols, TimeSpan span, Resolution? resolution = null) { return History(symbols, Time - span, Time, resolution); } /// /// Gets the historical data for the specified symbols. The exact number of bars will be returned for /// each symbol. This may result in some data start earlier/later than others due to when various /// exchanges are open. The symbols must exist in the Securities collection. /// /// The symbols to retrieve historical data for /// The number of bars to request /// The resolution to request /// An enumerable of slice containing the requested historical data public IEnumerable History(IEnumerable symbols, int periods, Resolution? resolution = null) { if (resolution == Resolution.Tick) throw new ArgumentException("History functions that accept a 'periods' parameter can not be used with Resolution.Tick"); return History(CreateBarCountHistoryRequests(symbols, periods, resolution)); } /// /// Gets the historical data for the specified symbols between the specified dates. The symbols must exist in the Securities collection. /// /// The symbols to retrieve historical data for /// The start time in the algorithm's time zone /// The end time in the algorithm's time zone /// The resolution to request /// True to fill forward missing data, false otherwise /// True to include extended market hours data, false otherwise /// An enumerable of slice containing the requested historical data public IEnumerable History(IEnumerable symbols, DateTime start, DateTime end, Resolution? resolution = null, bool? fillForward = null, bool? extendedMarket = null) { return History(CreateDateRangeHistoryRequests(symbols, start, end, resolution, fillForward, extendedMarket)); } /// /// Gets the start time required for the specified bar count in terms of the algorithm's time zone /// private DateTime GetStartTimeAlgoTz(Symbol symbol, int periods, Resolution? resolution = null) { var security = Securities[symbol]; var timeSpan = (resolution ?? security.Resolution).ToTimeSpan(); // make this a minimum of one second timeSpan = timeSpan < QuantConnect.Time.OneSecond ? QuantConnect.Time.OneSecond : timeSpan; var localStartTime = QuantConnect.Time.GetStartTimeForTradeBars(security.Exchange.Hours, UtcTime.ConvertFromUtc(security.Exchange.TimeZone), timeSpan, periods, security.IsExtendedMarketHours); return localStartTime.ConvertTo(security.Exchange.TimeZone, TimeZone); } /// /// Executes the specified history request /// /// the history request to execute /// An enumerable of slice satisfying the specified history request public IEnumerable History(HistoryRequest request) { return History(new[] {request}); } /// /// Executes the specified history requests /// /// the history requests to execute /// An enumerable of slice satisfying the specified history request public IEnumerable History(IEnumerable requests) { return History(requests, TimeZone); } private IEnumerable History(IEnumerable requests, DateTimeZone timeZone) { var sentMessage = false; var reqs = requests.ToList(); foreach (var request in reqs) { // prevent future requests if (request.EndTimeUtc > UtcTime) { request.EndTimeUtc = UtcTime; if (request.StartTimeUtc > request.EndTimeUtc) { request.StartTimeUtc = request.EndTimeUtc; } if (!sentMessage) { sentMessage = true; Debug("Request for future history modified to end now."); } } } // filter out future data to prevent look ahead bias return ((IAlgorithm) this).HistoryProvider.GetHistory(reqs, timeZone); } /// /// Helper method to create history requests from a date range /// private IEnumerable CreateDateRangeHistoryRequests(IEnumerable symbols, DateTime start, DateTime end, Resolution? resolution = null, bool? fillForward = null, bool? extendedMarket = null) { return symbols.Select(x => { var security = Securities[x]; var request = CreateHistoryRequest(security, start, end, resolution); // apply overrides Resolution? res = resolution ?? security.Resolution; if (fillForward.HasValue) request.FillForwardResolution = fillForward.Value ? res : null; if (extendedMarket.HasValue) request.IncludeExtendedMarketHours = extendedMarket.Value; return request; }); } /// /// Helper methods to create a history request for the specified symbols and bar count /// private IEnumerable CreateBarCountHistoryRequests(IEnumerable symbols, int periods, Resolution? resolution = null) { return symbols.Select(x => { var security = Securities[x]; Resolution? res = resolution ?? security.Resolution; var start = GetStartTimeAlgoTz(x, periods, res).ConvertToUtc(security.Exchange.TimeZone); return CreateHistoryRequest(security, start, UtcTime.RoundDown(res.Value.ToTimeSpan()), resolution); }); } private HistoryRequest CreateHistoryRequest(Security security, DateTime start, DateTime end, Resolution? resolution) { resolution = resolution ?? security.Resolution; var request = new HistoryRequest(security, start.ConvertToUtc(TimeZone), end.ConvertToUtc(TimeZone)) { Resolution = resolution.Value, FillForwardResolution = security.IsFillDataForward ? resolution : null }; return request; } } }