# 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.
from AlgorithmImports import *
###
### Demonstrate the usage of the BrokerageModel property to help improve backtesting
### accuracy through simulation of a specific brokerage's rules around restrictions
### on submitting orders as well as fee structure.
###
###
###
class BrokerageModelAlgorithm(QCAlgorithm):
def initialize(self):
self.set_cash(100000) # Set Strategy Cash
self.set_start_date(2013,10,7) # Set Start Date
self.set_end_date(2013,10,11) # Set End Date
self.add_equity("SPY", Resolution.SECOND)
# there's two ways to set your brokerage model. The easiest would be to call
# self.set_brokerage_model( BrokerageName ) # BrokerageName is an enum
# self.set_brokerage_model(BrokerageName.INTERACTIVE_BROKERS_BROKERAGE)
# self.set_brokerage_model(BrokerageName.DEFAULT)
# the other way is to call SetBrokerageModel( IBrokerageModel ) with your
# own custom model. I've defined a simple extension to the default brokerage
# model to take into account a requirement to maintain 500 cash in the account at all times
self.set_brokerage_model(MinimumAccountBalanceBrokerageModel(self,500.00))
self.last = 1
def on_data(self, slice):
# Simple buy and hold template
if not self.portfolio.invested:
self.set_holdings("SPY", self.last)
if self.portfolio["SPY"].quantity == 0:
# each time we fail to purchase we'll decrease our set holdings percentage
self.debug(str(self.time) + " - Failed to purchase stock")
self.last *= 0.95
else:
self.debug("{} - Purchased Stock @ SetHoldings( {} )".format(self.time, self.last))
class MinimumAccountBalanceBrokerageModel(DefaultBrokerageModel):
'''Custom brokerage model that requires clients to maintain a minimum cash balance'''
def __init__(self, algorithm, minimum_account_balance):
self.algorithm = algorithm
self.minimum_account_balance = minimum_account_balance
def can_submit_order(self,security, order, message):
'''Prevent orders which would bring the account below a minimum cash balance'''
message = None
# we want to model brokerage requirement of minimum_account_balance cash value in account
order_cost = order.get_value(security)
cash = self.algorithm.portfolio.cash
cash_after_order = cash - order_cost
if cash_after_order < self.minimum_account_balance:
# return a message describing why we're not allowing this order
message = BrokerageMessageEvent(BrokerageMessageType.WARNING, "InsufficientRemainingCapital", "Account must maintain a minimum of ${0} USD at all times. Order ID: {1}".format(self.minimum_account_balance, order.id))
self.algorithm.error(str(message))
return False
return True