/* * 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.Linq; namespace QuantConnect.Securities.Positions { /// /// Provides an implementation of for groups containing exactly one security /// public class SecurityPositionGroupBuyingPowerModel : PositionGroupBuyingPowerModel { /// /// Gets the margin currently allocated to the specified holding /// /// An object containing the security /// The maintenance margin required for the public override MaintenanceMargin GetMaintenanceMargin(PositionGroupMaintenanceMarginParameters parameters) { // SecurityPositionGroupBuyingPowerModel models buying power the same as non-grouped, so we can simply sum up // the reserved buying power via the security's model. We should really only ever get a single position here, // but it's not incorrect to ask the model for what the reserved buying power would be using default modeling var buyingPower = 0m; foreach (var position in parameters.PositionGroup) { var security = parameters.Portfolio.Securities[position.Symbol]; var result = security.BuyingPowerModel.GetMaintenanceMargin( MaintenanceMarginParameters.ForQuantityAtCurrentPrice(security, position.Quantity) ); buyingPower += result; } return buyingPower; } /// /// The margin that must be held in order to increase the position by the provided quantity /// /// An object containing the security and quantity public override InitialMargin GetInitialMarginRequirement(PositionGroupInitialMarginParameters parameters) { var initialMarginRequirement = 0m; foreach (var position in parameters.PositionGroup) { var security = parameters.Portfolio.Securities[position.Symbol]; initialMarginRequirement += security.BuyingPowerModel.GetInitialMarginRequirement( security, position.Quantity ); } return initialMarginRequirement; } /// /// Gets the total margin required to execute the specified order in units of the account currency including fees /// /// An object containing the portfolio, the security and the order /// The total margin in terms of the currency quoted in the order public override InitialMargin GetInitialMarginRequiredForOrder( PositionGroupInitialMarginForOrderParameters parameters ) { var initialMarginRequirement = 0m; foreach (var position in parameters.PositionGroup) { // TODO : Support combo order by pull symbol-specific order var security = parameters.Portfolio.Securities[position.Symbol]; initialMarginRequirement += security.BuyingPowerModel.GetInitialMarginRequiredForOrder( new InitialMarginRequiredForOrderParameters(parameters.Portfolio.CashBook, security, parameters.Order) ); } return initialMarginRequirement; } /// /// Get the maximum position group order quantity to obtain a position with a given buying power /// percentage. Will not take into account free buying power. /// /// An object containing the portfolio, the position group and the target /// signed buying power percentage /// Returns the maximum allowed market order quantity and if zero, also the reason public override GetMaximumLotsResult GetMaximumLotsForTargetBuyingPower( GetMaximumLotsForTargetBuyingPowerParameters parameters ) { if (parameters.PositionGroup.Count != 1) { return parameters.Error( $"{nameof(SecurityPositionGroupBuyingPowerModel)} only supports position groups containing exactly one position." ); } var position = parameters.PositionGroup.Single(); var security = parameters.Portfolio.Securities[position.Symbol]; var result = security.BuyingPowerModel.GetMaximumOrderQuantityForTargetBuyingPower( parameters.Portfolio, security, parameters.TargetBuyingPower, parameters.MinimumOrderMarginPortfolioPercentage ); var quantity = result.Quantity / security.SymbolProperties.LotSize; return new GetMaximumLotsResult(quantity, result.Reason, result.IsError); } /// /// Get the maximum market position group order quantity to obtain a delta in the buying power used by a position group. /// The deltas sign defines the position side to apply it to, positive long, negative short. /// /// An object containing the portfolio, the position group and the delta buying power /// Returns the maximum allowed market order quantity and if zero, also the reason /// Used by the margin call model to reduce the position by a delta percent. public override GetMaximumLotsResult GetMaximumLotsForDeltaBuyingPower( GetMaximumLotsForDeltaBuyingPowerParameters parameters ) { if (parameters.PositionGroup.Count != 1) { return parameters.Error( $"{nameof(SecurityPositionGroupBuyingPowerModel)} only supports position groups containing exactly one position." ); } var position = parameters.PositionGroup.Single(); var security = parameters.Portfolio.Securities[position.Symbol]; var result = security.BuyingPowerModel.GetMaximumOrderQuantityForDeltaBuyingPower( new GetMaximumOrderQuantityForDeltaBuyingPowerParameters( parameters.Portfolio, security, parameters.DeltaBuyingPower, parameters.MinimumOrderMarginPortfolioPercentage ) ); var quantity = result.Quantity / security.SymbolProperties.LotSize; return new GetMaximumLotsResult(quantity, result.Reason, result.IsError); } /// /// Check if there is sufficient buying power for the position group to execute this order. /// /// An object containing the portfolio, the position group and the order /// Returns buying power information for an order against a position group public override HasSufficientBuyingPowerForOrderResult HasSufficientBuyingPowerForOrder( HasSufficientPositionGroupBuyingPowerForOrderParameters parameters ) { if (parameters.PositionGroup.Count != 1) { return parameters.Error( $"{nameof(SecurityPositionGroupBuyingPowerModel)} only supports position groups containing exactly one position." ); } var position = parameters.PositionGroup.Single(); var security = parameters.Portfolio.Securities[position.Symbol]; return security.BuyingPowerModel.HasSufficientBuyingPowerForOrder( parameters.Portfolio, security, parameters.Orders.Single() ); } /// /// Additionally check initial margin requirements if the algorithm only has default position groups /// protected override HasSufficientBuyingPowerForOrderResult PassesPositionGroupSpecificBuyingPowerForOrderChecks( HasSufficientPositionGroupBuyingPowerForOrderParameters parameters, decimal availableBuyingPower ) { // only check initial margin requirements when the algorithm is only using default position groups if (!parameters.Portfolio.Positions.IsOnlyDefaultGroups) { return null; } var symbol = parameters.PositionGroup.Single().Symbol; var security = parameters.Portfolio.Securities[symbol]; return security.BuyingPowerModel.HasSufficientBuyingPowerForOrder( parameters.Portfolio, security, parameters.Orders.Single() ); } } }