/*
* 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.Data;
using QuantConnect.Data.Market;
using QuantConnect.Interfaces;
using QuantConnect.Orders;
using QuantConnect.Orders.Fees;
using QuantConnect.Orders.Fills;
using QuantConnect.Orders.Slippage;
using QuantConnect.Securities;
namespace QuantConnect.Algorithm.CSharp
{
///
/// Demonstration of using custom fee, slippage, fill, and buying power models for modelling transactions in backtesting.
/// QuantConnect allows you to model all orders as deeply and accurately as you need.
///
///
///
///
///
///
///
public class CustomModelsAlgorithm : QCAlgorithm, IRegressionAlgorithmDefinition
{
private Security _security;
private Symbol _spy;
public override void Initialize()
{
SetStartDate(2013, 10, 01);
SetEndDate(2013, 10, 31);
_security = AddEquity("SPY", Resolution.Hour);
_spy = _security.Symbol;
// set our models
_security.SetFeeModel(new CustomFeeModel(this));
_security.SetFillModel(new CustomFillModel(this));
_security.SetSlippageModel(new CustomSlippageModel(this));
_security.SetBuyingPowerModel(new CustomBuyingPowerModel(this));
}
public override void OnData(Slice slice)
{
var openOrders = Transactions.GetOpenOrders(_spy);
if (openOrders.Count != 0) return;
if (Time.Day > 10 && _security.Holdings.Quantity <= 0)
{
var quantity = CalculateOrderQuantity(_spy, .5m);
Log($"MarketOrder: {quantity}");
MarketOrder(_spy, quantity, asynchronous: true); // async needed for partial fill market orders
}
else if (Time.Day > 20 && _security.Holdings.Quantity >= 0)
{
var quantity = CalculateOrderQuantity(_spy, -.5m);
Log($"MarketOrder: {quantity}");
MarketOrder(_spy, quantity, asynchronous: true); // async needed for partial fill market orders
}
}
public class CustomFillModel : ImmediateFillModel
{
private readonly QCAlgorithm _algorithm;
private readonly Random _random = new Random(387510346); // seed it for reproducibility
private readonly Dictionary _absoluteRemainingByOrderId = new Dictionary();
public CustomFillModel(QCAlgorithm algorithm)
{
_algorithm = algorithm;
}
public override OrderEvent MarketFill(Security asset, MarketOrder order)
{
// this model randomly fills market orders
decimal absoluteRemaining;
if (!_absoluteRemainingByOrderId.TryGetValue(order.Id, out absoluteRemaining))
{
absoluteRemaining = order.AbsoluteQuantity;
_absoluteRemainingByOrderId.Add(order.Id, order.AbsoluteQuantity);
}
var fill = base.MarketFill(asset, order);
var absoluteFillQuantity = (int) (Math.Min(absoluteRemaining, _random.Next(0, 2*(int)order.AbsoluteQuantity)));
fill.FillQuantity = Math.Sign(order.Quantity) * absoluteFillQuantity;
if (absoluteRemaining == absoluteFillQuantity)
{
fill.Status = OrderStatus.Filled;
_absoluteRemainingByOrderId.Remove(order.Id);
}
else
{
absoluteRemaining = absoluteRemaining - absoluteFillQuantity;
_absoluteRemainingByOrderId[order.Id] = absoluteRemaining;
fill.Status = OrderStatus.PartiallyFilled;
}
_algorithm.Log($"CustomFillModel: {fill}");
return fill;
}
}
public class CustomFeeModel : FeeModel
{
private readonly QCAlgorithm _algorithm;
public CustomFeeModel(QCAlgorithm algorithm)
{
_algorithm = algorithm;
}
public override OrderFee GetOrderFee(OrderFeeParameters parameters)
{
// custom fee math
var fee = Math.Max(
1m,
parameters.Security.Price*parameters.Order.AbsoluteQuantity*0.00001m);
_algorithm.Log($"CustomFeeModel: {fee}");
return new OrderFee(new CashAmount(fee, "USD"));
}
}
public class CustomSlippageModel : ISlippageModel
{
private readonly QCAlgorithm _algorithm;
public CustomSlippageModel(QCAlgorithm algorithm)
{
_algorithm = algorithm;
}
public decimal GetSlippageApproximation(Security asset, Order order)
{
// custom slippage math
var slippage = asset.Price*0.0001m*(decimal) Math.Log10(2*(double) order.AbsoluteQuantity);
_algorithm.Log($"CustomSlippageModel: {slippage}");
return slippage;
}
}
public class CustomBuyingPowerModel : BuyingPowerModel
{
private readonly QCAlgorithm _algorithm;
public CustomBuyingPowerModel(QCAlgorithm algorithm)
{
_algorithm = algorithm;
}
public override HasSufficientBuyingPowerForOrderResult HasSufficientBuyingPowerForOrder(
HasSufficientBuyingPowerForOrderParameters parameters)
{
// custom behavior: this model will assume that there is always enough buying power
var hasSufficientBuyingPowerForOrderResult = new HasSufficientBuyingPowerForOrderResult(true);
_algorithm.Log($"CustomBuyingPowerModel: {hasSufficientBuyingPowerForOrderResult.IsSufficient}");
return hasSufficientBuyingPowerForOrderResult;
}
}
///
/// The simple fill model shows how to implement a simpler version of
/// the most popular order fills: Market, Stop Market and Limit
///
public class SimpleCustomFillModel : FillModel
{
private static OrderEvent CreateOrderEvent(Security asset, Order order)
{
var utcTime = asset.LocalTime.ConvertToUtc(asset.Exchange.TimeZone);
return new OrderEvent(order, utcTime, OrderFee.Zero);
}
private static OrderEvent SetOrderEventToFilled(OrderEvent fill, decimal fillPrice, decimal fillQuantity)
{
fill.Status = OrderStatus.Filled;
fill.FillQuantity = fillQuantity;
fill.FillPrice = fillPrice;
return fill;
}
private static TradeBar GetTradeBar(Security asset, OrderDirection orderDirection)
{
var tradeBar = asset.Cache.GetData();
if (tradeBar != null) return tradeBar;
// Tick-resolution data doesn't have TradeBar, use the asset price
var price = asset.Price;
return new TradeBar(asset.LocalTime, asset.Symbol, price, price, price, price, 0);
}
public override OrderEvent MarketFill(Security asset, MarketOrder order)
{
var fill = CreateOrderEvent(asset, order);
if (order.Status == OrderStatus.Canceled) return fill;
return SetOrderEventToFilled(fill,
order.Direction == OrderDirection.Buy
? asset.Cache.AskPrice
: asset.Cache.BidPrice,
order.Quantity);
}
public override OrderEvent StopMarketFill(Security asset, StopMarketOrder order)
{
var fill = CreateOrderEvent(asset, order);
if (order.Status == OrderStatus.Canceled) return fill;
var stopPrice = order.StopPrice;
var tradeBar = GetTradeBar(asset, order.Direction);
return order.Direction switch
{
OrderDirection.Buy => tradeBar.Low < stopPrice
? SetOrderEventToFilled(fill, stopPrice, order.Quantity)
: fill,
OrderDirection.Sell => tradeBar.High > stopPrice
? SetOrderEventToFilled(fill, stopPrice, order.Quantity)
: fill,
_ => fill
};
}
public override OrderEvent LimitFill(Security asset, LimitOrder order)
{
var fill = CreateOrderEvent(asset, order);
if (order.Status == OrderStatus.Canceled) return fill;
var limitPrice = order.LimitPrice;
var tradeBar = GetTradeBar(asset, order.Direction);
return order.Direction switch
{
OrderDirection.Buy => tradeBar.High > limitPrice
? SetOrderEventToFilled(fill, limitPrice, order.Quantity)
: fill,
OrderDirection.Sell => tradeBar.Low < limitPrice
? SetOrderEventToFilled(fill, limitPrice, order.Quantity)
: fill,
_ => fill
};
}
}
///
/// This is used by the regression test system to indicate if the open source Lean repository has the required data to run this algorithm.
///
public bool CanRunLocally { get; } = true;
///
/// This is used by the regression test system to indicate which languages this algorithm is written in.
///
public List Languages { get; } = new() { Language.CSharp, Language.Python };
///
/// Data Points count of all timeslices of algorithm
///
public long DataPoints => 330;
///
/// Data Points count of the algorithm history
///
public int AlgorithmHistoryDataPoints => 0;
///
/// Final status of the algorithm
///
public AlgorithmStatus AlgorithmStatus => AlgorithmStatus.Completed;
///
/// This is used by the regression test system to indicate what the expected statistics are from running the algorithm
///
public Dictionary ExpectedStatistics => new Dictionary
{
{"Total Orders", "63"},
{"Average Win", "0.11%"},
{"Average Loss", "-0.06%"},
{"Compounding Annual Return", "-7.236%"},
{"Drawdown", "2.400%"},
{"Expectancy", "-0.187"},
{"Start Equity", "100000"},
{"End Equity", "99370.95"},
{"Net Profit", "-0.629%"},
{"Sharpe Ratio", "-1.47"},
{"Sortino Ratio", "-2.086"},
{"Probabilistic Sharpe Ratio", "21.874%"},
{"Loss Rate", "70%"},
{"Win Rate", "30%"},
{"Profit-Loss Ratio", "1.73"},
{"Alpha", "-0.102"},
{"Beta", "0.122"},
{"Annual Standard Deviation", "0.04"},
{"Annual Variance", "0.002"},
{"Information Ratio", "-4.126"},
{"Tracking Error", "0.102"},
{"Treynor Ratio", "-0.479"},
{"Total Fees", "$62.25"},
{"Estimated Strategy Capacity", "$52000000.00"},
{"Lowest Capacity Asset", "SPY R735QTJ8XC9X"},
{"Portfolio Turnover", "197.95%"},
{"Drawdown Recovery", "2"},
{"OrderListHash", "709bbf9af9ec6b43a10617dc192a6a5b"}
};
}
}