/*
* 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;
}
}
}