/* * 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 QuantConnect.Interfaces; using QuantConnect.Securities; using QuantConnect.Orders.Fills; using QuantConnect.Configuration; namespace QuantConnect { /// /// This class includes user settings for the algorithm which can be changed in the method /// public class AlgorithmSettings : IAlgorithmSettings { private static TimeSpan _defaultDatabasesRefreshPeriod = TimeSpan.TryParse(Config.Get("databases-refresh-period", "1.00:00:00"), out var refreshPeriod) ? refreshPeriod : Time.OneDay; // We default this to true so that we don't terminate live algorithms when the // brokerage account has existing holdings for an asset that is not supported by Lean. // Users can override this on initialization so that the algorithm is not terminated when // placing orders for assets without a correct definition or mapping. private static bool _defaultIgnoreUnknownAssetHoldings = Config.GetBool("ignore-unknown-asset-holdings", true); /// /// Gets whether or not WarmUpIndicator is allowed to warm up indicators /// public bool AutomaticIndicatorWarmUp { get; set; } /// /// True if should rebalance portfolio on security changes. True by default /// public bool? RebalancePortfolioOnSecurityChanges { get; set; } /// /// True if should rebalance portfolio on new insights or expiration of insights. True by default /// public bool? RebalancePortfolioOnInsightChanges { get; set; } /// /// The absolute maximum valid total portfolio value target percentage /// /// This setting is currently being used to filter out undesired target percent values, /// caused by the IPortfolioConstructionModel implementation being used. /// For example rounding errors, math operations public decimal MaxAbsolutePortfolioTargetPercentage { get; set; } /// /// The absolute minimum valid total portfolio value target percentage /// /// This setting is currently being used to filter out undesired target percent values, /// caused by the IPortfolioConstructionModel implementation being used. /// For example rounding errors, math operations public decimal MinAbsolutePortfolioTargetPercentage { get; set; } /// /// Configurable minimum order margin portfolio percentage to ignore bad orders, orders with unrealistic small sizes /// /// Default value is 0.1% of the portfolio value. This setting is useful to avoid small trading noise when using SetHoldings public decimal MinimumOrderMarginPortfolioPercentage { get; set; } /// /// Gets/sets the maximum number of concurrent market data subscriptions available /// /// /// All securities added with are counted as one, /// with the exception of options and futures where every single contract in a chain counts as one. /// [Obsolete("This property is deprecated. Please observe data subscription limits set by your brokerage to avoid runtime errors.")] public int DataSubscriptionLimit { get; set; } = int.MaxValue; /// /// Gets/sets the SetHoldings buffers value. /// The buffer is used for orders not to be rejected due to volatility when using SetHoldings and CalculateOrderQuantity /// public decimal? FreePortfolioValue { get; set; } /// /// Gets/sets the SetHoldings buffers value percentage. /// This percentage will be used to set the /// based on the /// public decimal FreePortfolioValuePercentage { get; set; } /// /// Gets/sets if Liquidate() is enabled /// public bool LiquidateEnabled { get; set; } /// /// Gets/sets the minimum time span elapsed to consider a market fill price as stale (defaults to one hour) /// /// /// In the default fill models, a warning message will be added to market order fills /// if this time span (or more) has elapsed since the price was last updated. /// /// /// public TimeSpan StalePriceTimeSpan { get; set; } /// /// The warmup resolution to use if any /// /// This allows improving the warmup speed by setting it to a lower resolution than the one added in the algorithm public Resolution? WarmupResolution { get; set; } /// /// The warmup resolution to use if any /// /// This allows improving the warmup speed by setting it to a lower resolution than the one added in the algorithm. /// Pass through version to be user friendly public Resolution? WarmUpResolution { get { return WarmupResolution; } set { WarmupResolution = value; } } /// /// Number of trading days per year for this Algorithm's portfolio statistics. /// /// Effect on /// , /// , /// , /// , /// , /// . /// public int? TradingDaysPerYear { get; set; } /// /// True if daily strict end times are enabled /// public bool DailyPreciseEndTime { get; set; } /// /// True if extended market hours should be used for daily consolidation, when extended market hours is enabled /// public bool DailyConsolidationUseExtendedMarketHours { get; set; } /// /// Gets the time span used to refresh the market hours and symbol properties databases /// public TimeSpan DatabasesRefreshPeriod { get; set; } /// /// Determines whether to terminate the algorithm when an asset holding is not supported by Lean or the brokerage. /// Defaults to true, meaning that the algorithm will not be terminated if an asset holding is not supported. /// public bool IgnoreUnknownAssetHoldings { get; set; } /// /// Initializes a new instance of the class /// public AlgorithmSettings() { LiquidateEnabled = true; DailyPreciseEndTime = true; FreePortfolioValuePercentage = 0.0025m; // Because the free portfolio value has a trailing behavior by default, let's add a default minimum order margin portfolio percentage // to avoid tiny trades when rebalancing, defaulting to 0.1% of the TPV MinimumOrderMarginPortfolioPercentage = 0.001m; StalePriceTimeSpan = Time.OneHour; MaxAbsolutePortfolioTargetPercentage = 1000000000; MinAbsolutePortfolioTargetPercentage = 0.0000000001m; DatabasesRefreshPeriod = _defaultDatabasesRefreshPeriod; IgnoreUnknownAssetHoldings = _defaultIgnoreUnknownAssetHoldings; } } }