/* * 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 Python.Runtime; using QuantConnect.Benchmarks; using QuantConnect.Brokerages; using QuantConnect.Data.Market; using QuantConnect.Data.Shortable; using QuantConnect.Interfaces; using QuantConnect.Orders; using QuantConnect.Orders.Fees; using QuantConnect.Orders.Fills; using QuantConnect.Orders.Slippage; using QuantConnect.Securities; namespace QuantConnect.Python { /// /// Provides an implementation of that wraps a object /// public class BrokerageModelPythonWrapper : IBrokerageModel { private readonly dynamic _model; /// /// Constructor for initialising the class with wrapped object /// /// Models brokerage transactions, fees, and order public BrokerageModelPythonWrapper(PyObject model) { _model = model; } /// /// Gets or sets the account type used by this model /// public AccountType AccountType { get { using (Py.GIL()) { return (_model.AccountType as PyObject).GetAndDispose(); } } } /// /// Gets the brokerages model percentage factor used to determine the required unused buying power for the account. /// From 1 to 0. Example: 0 means no unused buying power is required. 0.5 means 50% of the buying power should be left unused. /// public decimal RequiredFreeBuyingPowerPercent { get { using (Py.GIL()) { return (_model.RequiredFreeBuyingPowerPercent as PyObject).GetAndDispose(); } } } /// /// Gets a map of the default markets to be used for each security type /// public IReadOnlyDictionary DefaultMarkets { get { using (Py.GIL()) { var markets = _model.DefaultMarkets; if ((markets as PyObject).TryConvert(out IReadOnlyDictionary csharpDic)) { return csharpDic; } var dic = new Dictionary(); foreach (var item in markets) { using var pyItem = item as PyObject; var market = pyItem.As(); dic[market] = markets[item]; } (markets as PyObject).Dispose(); return dic; } } } /// /// Applies the split to the specified order ticket /// /// The open tickets matching the split event /// The split event data public void ApplySplit(List tickets, Split split) { using (Py.GIL()) { _model.ApplySplit(tickets, split); } } /// /// Returns true if the brokerage would be able to execute this order at this time assuming /// market prices are sufficient for the fill to take place. This is used to emulate the /// brokerage fills in backtesting and paper trading. For example some brokerages may not perform /// executions during extended market hours. This is not intended to be checking whether or not /// the exchange is open, that is handled in the Security.Exchange property. /// /// The security being ordered /// The order to test for execution /// True if the brokerage would be able to perform the execution, false otherwise public bool CanExecuteOrder(Security security, Order order) { using (Py.GIL()) { return (_model.CanExecuteOrder(security, order) as PyObject).GetAndDispose(); } } /// /// 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 security being ordered /// 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 bool CanSubmitOrder(Security security, Order order, out BrokerageMessageEvent message) { using (Py.GIL()) { using var result = _model.CanSubmitOrder(security, order, out message) as PyObject; // Since pythonnet does not support out parameters, the methods return // a tuple where the out parameter comes after the other returned values if (!PyTuple.IsTupleType(result)) { throw new ArgumentException($@"{_model.__class__.__name__}.CanSubmitOrder(): Must return a tuple value where the first value is a bool and the second a BrokerageMessageEvent"); } message = result[1].As(); return result[0].As(); } } /// /// 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 updated 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 bool CanUpdateOrder(Security security, Order order, UpdateOrderRequest request, out BrokerageMessageEvent message) { using (Py.GIL()) { using var result = _model.CanUpdateOrder(security,order, request, out message) as PyObject; // Since pythonnet does not support out parameters, the methods return // a tuple where the out parameter comes after the other returned values if (!PyTuple.IsTupleType(result)) { throw new ArgumentException($@"{_model.__class__.__name__}.CanUpdateOrder(): Must return a tuple value where the first value is a bool and the second a BrokerageMessageEvent"); } message = result[1].As(); return result[0].As(); } } /// /// Get the benchmark for this model /// /// SecurityService to create the security with if needed /// The benchmark for this brokerage public IBenchmark GetBenchmark(SecurityManager securities) { using (Py.GIL()) { var benchmark = _model.GetBenchmark(securities) as PyObject; if (benchmark.TryConvert(out var csharpBenchmark)) { return csharpBenchmark; } return new BenchmarkPythonWrapper(benchmark); } } /// /// 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 IFeeModel GetFeeModel(Security security) { using (Py.GIL()) { var feeModel = _model.GetFeeModel(security) as PyObject; if (feeModel.TryConvert(out var csharpFeeModel)) { return csharpFeeModel; } return new FeeModelPythonWrapper(feeModel); } } /// /// Gets a new fill model that represents this brokerage's fill behavior /// /// The security to get fill model for /// The new fill model for this brokerage public IFillModel GetFillModel(Security security) { using (Py.GIL()) { var fillModel = _model.GetFillModel(security) as PyObject; if (fillModel.TryConvert(out var csharpFillModel)) { return csharpFillModel; } return new FillModelPythonWrapper(fillModel); } } /// /// Gets the brokerage's leverage for the specified security /// /// The security's whose leverage we seek /// The leverage for the specified security public decimal GetLeverage(Security security) { using (Py.GIL()) { return (_model.GetLeverage(security) as PyObject).GetAndDispose(); } } /// /// Gets a new settlement model for the security /// /// The security to get a settlement model for /// The settlement model for this brokerage public ISettlementModel GetSettlementModel(Security security) { using (Py.GIL()) { var settlementModel = _model.GetSettlementModel(security) as PyObject; if (settlementModel.TryConvert(out var csharpSettlementModel)) { return csharpSettlementModel; } return new SettlementModelPythonWrapper(settlementModel); } } /// /// Gets a new settlement model for the security /// /// The security to get a settlement model for /// The account type /// The settlement model for this brokerage [Obsolete("Flagged deprecated and will remove December 1st 2018")] public ISettlementModel GetSettlementModel(Security security, AccountType accountType) { using (Py.GIL()) { return (_model.GetSettlementModel(security, accountType) as PyObject).GetAndDispose(); } } /// /// Gets a new slippage model that represents this brokerage's fill slippage behavior /// /// The security to get a slippage model for /// The new slippage model for this brokerage public ISlippageModel GetSlippageModel(Security security) { using (Py.GIL()) { var slippageModel = _model.GetSlippageModel(security) as PyObject; if (slippageModel.TryConvert(out var csharpSlippageModel)) { return csharpSlippageModel; } return new SlippageModelPythonWrapper(slippageModel); } } /// /// Determine if this symbol is shortable /// /// The algorithm running /// The symbol to short /// The amount to short /// public bool Shortable(IAlgorithm algorithm, Symbol symbol, decimal quantity) { using (Py.GIL()) { return (_model.Shortable(algorithm, symbol, quantity) as PyObject).GetAndDispose(); } } /// /// Gets a new buying power model for the security, returning the default model with the security's configured leverage. /// For cash accounts, leverage = 1 is used. /// /// The security to get a buying power model for /// The buying power model for this brokerage/security public IBuyingPowerModel GetBuyingPowerModel(Security security) { using (Py.GIL()) { var buyingPowerModel = _model.GetBuyingPowerModel(security) as PyObject; if (buyingPowerModel.TryConvert(out var csharpBuyingPowerModel)) { return csharpBuyingPowerModel; } return new BuyingPowerModelPythonWrapper(buyingPowerModel); } } /// /// Gets a new buying power model for the security /// /// The security to get a buying power model for /// The account type /// The buying power model for this brokerage/security [Obsolete("Flagged deprecated and will remove December 1st 2018")] public IBuyingPowerModel GetBuyingPowerModel(Security security, AccountType accountType) { using (Py.GIL()) { return (_model.GetBuyingPowerModel(security, accountType) as PyObject).GetAndDispose(); } } /// /// Gets the shortable provider /// /// Shortable provider public IShortableProvider GetShortableProvider(Security security) { using (Py.GIL()) { var shortableProvider = _model.GetShortableProvider(security) as PyObject; if (shortableProvider.TryConvert(out var csharpShortableProvider)) { return csharpShortableProvider; } return new ShortableProviderPythonWrapper(shortableProvider); } } /// /// Convenience method to get the underlying object from the wrapper. /// /// Underlying object public IBrokerageModel GetModel() { using (Py.GIL()) { return (_model as PyObject).AsManagedObject(typeof(IBrokerageModel)) as IBrokerageModel; } } /// /// Gets a new margin interest rate model for the security /// /// The security to get a margin interest rate model for /// The margin interest rate model for this brokerage public IMarginInterestRateModel GetMarginInterestRateModel(Security security) { using (Py.GIL()) { var marginInterestRateModel = _model.GetMarginInterestRateModel(security) as PyObject; if (marginInterestRateModel.TryConvert(out var csharpBuyingPowerModel)) { return csharpBuyingPowerModel; } return new MarginInterestRateModelPythonWrapper(marginInterestRateModel); } } } }