/* * 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 QuantConnect.Benchmarks; using QuantConnect.Orders; using QuantConnect.Orders.Fees; using QuantConnect.Orders.Slippage; using QuantConnect.Securities; using QuantConnect.Util; namespace QuantConnect.Brokerages { /// /// Provides FXCM specific properties /// public class FxcmBrokerageModel : DefaultBrokerageModel { /// /// The default markets for the fxcm brokerage /// public new static readonly IReadOnlyDictionary DefaultMarketMap = new Dictionary { {SecurityType.Base, Market.USA}, {SecurityType.Equity, Market.USA}, {SecurityType.Option, Market.USA}, {SecurityType.Forex, Market.FXCM}, {SecurityType.Cfd, Market.FXCM} }.ToReadOnlyDictionary(); private readonly HashSet _supportedOrderTypes = new() { OrderType.Limit, OrderType.Market, OrderType.StopMarket }; /// /// Gets a map of the default markets to be used for each security type /// public override IReadOnlyDictionary DefaultMarkets => DefaultMarketMap; /// /// Initializes a new instance of the class /// /// The type of account to be modelled, defaults to /// public FxcmBrokerageModel(AccountType accountType = AccountType.Margin) : base(accountType) { } /// /// Returns true if the brokerage could accept this order. This takes into account /// order type, security type, and order size limits. /// /// /// For example, a brokerage may have no connectivity at certain times, or an order rate/size limit /// /// /// The order to be processed /// If this function returns false, a brokerage message detailing why the order may not be submitted /// True if the brokerage could process the order, false otherwise public override bool CanSubmitOrder(Security security, Order order, out BrokerageMessageEvent message) { message = null; // validate security type if (security.Type != SecurityType.Forex && security.Type != SecurityType.Cfd) { message = new BrokerageMessageEvent(BrokerageMessageType.Warning, "NotSupported", Messages.DefaultBrokerageModel.UnsupportedSecurityType(this, security)); return false; } // validate order type if (!_supportedOrderTypes.Contains(order.Type)) { message = new BrokerageMessageEvent(BrokerageMessageType.Warning, "NotSupported", Messages.DefaultBrokerageModel.UnsupportedOrderType(this, order, _supportedOrderTypes)); return false; } // validate order quantity if (order.Quantity % security.SymbolProperties.LotSize != 0) { message = new BrokerageMessageEvent(BrokerageMessageType.Warning, "NotSupported", Messages.FxcmBrokerageModel.InvalidOrderQuantityForLotSize(security)); return false; } // validate stop/limit orders prices var limit = order as LimitOrder; if (limit != null) { return IsValidOrderPrices(security, OrderType.Limit, limit.Direction, security.Price, limit.LimitPrice, ref message); } var stopMarket = order as StopMarketOrder; if (stopMarket != null) { return IsValidOrderPrices(security, OrderType.StopMarket, stopMarket.Direction, stopMarket.StopPrice, security.Price, ref message); } // validate time in force if (order.TimeInForce != TimeInForce.GoodTilCanceled) { message = new BrokerageMessageEvent(BrokerageMessageType.Warning, "NotSupported", Messages.DefaultBrokerageModel.UnsupportedTimeInForce(this, order)); return false; } return true; } /// /// Returns true if the brokerage would allow updating the order as specified by the request /// /// The security of the order /// The order to be updated /// The requested update to be made to the order /// If this function returns false, a brokerage message detailing why the order may not be updated /// True if the brokerage would allow updating the order, false otherwise public override bool CanUpdateOrder(Security security, Order order, UpdateOrderRequest request, out BrokerageMessageEvent message) { message = null; // validate order quantity if (request.Quantity != null && request.Quantity % security.SymbolProperties.LotSize != 0) { message = new BrokerageMessageEvent(BrokerageMessageType.Warning, "NotSupported", Messages.FxcmBrokerageModel.InvalidOrderQuantityForLotSize(security)); return false; } // determine direction via the new, updated quantity var newQuantity = request.Quantity ?? order.Quantity; var direction = newQuantity > 0 ? OrderDirection.Buy : OrderDirection.Sell; // use security.Price if null, allows to pass checks var stopPrice = request.StopPrice ?? security.Price; var limitPrice = request.LimitPrice ?? security.Price; return IsValidOrderPrices(security, order.Type, direction, stopPrice, limitPrice, ref message); } /// /// Get the benchmark for this model /// /// SecurityService to create the security with if needed /// The benchmark for this brokerage public override IBenchmark GetBenchmark(SecurityManager securities) { var symbol = Symbol.Create("EURUSD", SecurityType.Forex, Market.FXCM); return SecurityBenchmark.CreateInstance(securities, symbol); } /// /// Gets a new fee model that represents this brokerage's fee structure /// /// The security to get a fee model for /// The new fee model for this brokerage public override IFeeModel GetFeeModel(Security security) { return new FxcmFeeModel(); } /// /// Gets a new settlement model for the security /// /// The security to get a settlement model for /// The settlement model for this brokerage public override ISettlementModel GetSettlementModel(Security security) { return security.Type == SecurityType.Cfd ? new AccountCurrencyImmediateSettlementModel() : (ISettlementModel)new ImmediateSettlementModel(); } /// /// Validates limit/stopmarket order prices, pass security.Price for limit/stop if n/a /// private static bool IsValidOrderPrices(Security security, OrderType orderType, OrderDirection orderDirection, decimal stopPrice, decimal limitPrice, ref BrokerageMessageEvent message) { // validate order price var invalidPrice = orderType == OrderType.Limit && orderDirection == OrderDirection.Buy && limitPrice > security.Price || orderType == OrderType.Limit && orderDirection == OrderDirection.Sell && limitPrice < security.Price || orderType == OrderType.StopMarket && orderDirection == OrderDirection.Buy && stopPrice < security.Price || orderType == OrderType.StopMarket && orderDirection == OrderDirection.Sell && stopPrice > security.Price; if (invalidPrice) { message = new BrokerageMessageEvent(BrokerageMessageType.Warning, "NotSupported", Messages.FxcmBrokerageModel.InvalidOrderPrice); return false; } // Validate FXCM maximum distance for limit and stop orders: // there are two different Max Limits, 15000 pips and 50% rule, // whichever comes first (for most pairs, 50% rule comes first) var maxDistance = Math.Min( // MinimumPriceVariation is 1/10th of a pip security.SymbolProperties.MinimumPriceVariation * 10 * 15000, security.Price / 2); var currentPrice = security.Price; var minPrice = currentPrice - maxDistance; var maxPrice = currentPrice + maxDistance; var outOfRangePrice = orderType == OrderType.Limit && orderDirection == OrderDirection.Buy && limitPrice < minPrice || orderType == OrderType.Limit && orderDirection == OrderDirection.Sell && limitPrice > maxPrice || orderType == OrderType.StopMarket && orderDirection == OrderDirection.Buy && stopPrice > maxPrice || orderType == OrderType.StopMarket && orderDirection == OrderDirection.Sell && stopPrice < minPrice; if (outOfRangePrice) { var orderPrice = orderType == OrderType.Limit ? limitPrice : stopPrice; message = new BrokerageMessageEvent(BrokerageMessageType.Warning, "NotSupported", Messages.FxcmBrokerageModel.PriceOutOfRange(orderType, orderDirection, orderPrice, currentPrice)); return false; } return true; } } }