加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
文件
克隆/下载
trade.py 11.39 KB
一键复制 编辑 原始数据 按行查看 历史
云金杞 提交于 2021-12-18 20:38 . update backtrader files
#!/usr/bin/env python
# -*- coding: utf-8; py-indent-offset:4 -*-
###############################################################################
#
# Copyright (C) 2015-2020 Daniel Rodriguez
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
###############################################################################
from __future__ import (absolute_import, division, print_function,
unicode_literals)
import itertools
from .utils import AutoOrderedDict
from .utils.date import num2date
from .utils.py3 import range
class TradeHistory(AutoOrderedDict):
'''Represents the status and update event for each update a Trade has
This object is a dictionary which allows '.' notation
Attributes:
- ``status`` (``dict`` with '.' notation): Holds the resulting status of
an update event and has the following sub-attributes
- ``status`` (``int``): Trade status
- ``dt`` (``float``): float coded datetime
- ``barlen`` (``int``): number of bars the trade has been active
- ``size`` (``int``): current size of the Trade
- ``price`` (``float``): current price of the Trade
- ``value`` (``float``): current monetary value of the Trade
- ``pnl`` (``float``): current profit and loss of the Trade
- ``pnlcomm`` (``float``): current profit and loss minus commission
- ``event`` (``dict`` with '.' notation): Holds the event update
- parameters
- ``order`` (``object``): the order which initiated the``update``
- ``size`` (``int``): size of the update
- ``price`` (``float``):price of the update
- ``commission`` (``float``): price of the update
'''
def __init__(self,
status, dt, barlen, size, price, value, pnl, pnlcomm, tz, event=None):
'''Initializes the object to the current status of the Trade'''
super(TradeHistory, self).__init__()
self.status.status = status
self.status.dt = dt
self.status.barlen = barlen
self.status.size = size
self.status.price = price
self.status.value = value
self.status.pnl = pnl
self.status.pnlcomm = pnlcomm
self.status.tz = tz
if event is not None:
self.event = event
def __reduce__(self):
return (self.__class__, (self.status.status, self.status.dt, self.status.barlen, self.status.size,
self.status.price, self.status.value, self.status.pnl, self.status.pnlcomm,
self.status.tz, self.event, ))
def doupdate(self, order, size, price, commission):
'''Used to fill the ``update`` part of the history entry'''
self.event.order = order
self.event.size = size
self.event.price = price
self.event.commission = commission
# Do not allow updates (avoids typing errors)
self._close()
def datetime(self, tz=None, naive=True):
'''Returns a datetime for the time the update event happened'''
return num2date(self.status.dt, tz or self.status.tz, naive)
class Trade(object):
'''Keeps track of the life of an trade: size, price,
commission (and value?)
An trade starts at 0 can be increased and reduced and can
be considered closed if it goes back to 0.
The trade can be long (positive size) or short (negative size)
An trade is not meant to be reversed (no support in the logic for it)
Member Attributes:
- ``ref``: unique trade identifier
- ``status`` (``int``): one of Created, Open, Closed
- ``tradeid``: grouping tradeid passed to orders during creation
The default in orders is 0
- ``size`` (``int``): current size of the trade
- ``price`` (``float``): current price of the trade
- ``value`` (``float``): current value of the trade
- ``commission`` (``float``): current accumulated commission
- ``pnl`` (``float``): current profit and loss of the trade (gross pnl)
- ``pnlcomm`` (``float``): current profit and loss of the trade minus
commission (net pnl)
- ``isclosed`` (``bool``): records if the last update closed (set size to
null the trade
- ``isopen`` (``bool``): records if any update has opened the trade
- ``justopened`` (``bool``): if the trade was just opened
- ``baropen`` (``int``): bar in which this trade was opened
- ``dtopen`` (``float``): float coded datetime in which the trade was
opened
- Use method ``open_datetime`` to get a Python datetime.datetime
or use the platform provided ``num2date`` method
- ``barclose`` (``int``): bar in which this trade was closed
- ``dtclose`` (``float``): float coded datetime in which the trade was
closed
- Use method ``close_datetime`` to get a Python datetime.datetime
or use the platform provided ``num2date`` method
- ``barlen`` (``int``): number of bars this trade was open
- ``historyon`` (``bool``): whether history has to be recorded
- ``history`` (``list``): holds a list updated with each "update" event
containing the resulting status and parameters used in the update
The first entry in the history is the Opening Event
The last entry in the history is the Closing Event
'''
refbasis = itertools.count(1)
status_names = ['Created', 'Open', 'Closed']
Created, Open, Closed = range(3)
def __str__(self):
toprint = (
'ref', 'data', 'tradeid',
'size', 'price', 'value', 'commission', 'pnl', 'pnlcomm',
'justopened', 'isopen', 'isclosed',
'baropen', 'dtopen', 'barclose', 'dtclose', 'barlen',
'historyon', 'history',
'status')
return '\n'.join(
(':'.join((x, str(getattr(self, x)))) for x in toprint)
)
def __init__(self, data=None, tradeid=0, historyon=False,
size=0, price=0.0, value=0.0, commission=0.0):
self.ref = next(self.refbasis)
self.data = data
self.tradeid = tradeid
self.size = size
self.price = price
self.value = value
self.commission = commission
self.pnl = 0.0
self.pnlcomm = 0.0
self.justopened = False
self.isopen = False
self.isclosed = False
self.baropen = 0
self.dtopen = 0.0
self.barclose = 0
self.dtclose = 0.0
self.barlen = 0
self.historyon = historyon
self.history = list()
self.status = self.Created
def __len__(self):
'''Absolute size of the trade'''
return abs(self.size)
def __bool__(self):
'''Trade size is not 0'''
return self.size != 0
__nonzero__ = __bool__
def getdataname(self):
'''Shortcut to retrieve the name of the data this trade references'''
return self.data._name
def open_datetime(self, tz=None, naive=True):
'''Returns a datetime.datetime object with the datetime in which
the trade was opened
'''
return self.data.num2date(self.dtopen, tz=tz, naive=naive)
def close_datetime(self, tz=None, naive=True):
'''Returns a datetime.datetime object with the datetime in which
the trade was closed
'''
return self.data.num2date(self.dtclose, tz=tz, naive=naive)
def update(self, order, size, price, value, commission, pnl,
comminfo):
'''
Updates the current trade. The logic does not check if the
trade is reversed, which is not conceptually supported by the
object.
If an update sets the size attribute to 0, "closed" will be
set to true
Updates may be received twice for each order, once for the existing
size which has been closed (sell undoing a buy) and a second time for
the the opening part (sell reversing a buy)
Args:
order: the order object which has (completely or partially)
generated this update
size (int): amount to update the order
if size has the same sign as the current trade a
position increase will happen
if size has the opposite sign as current op size a
reduction/close will happen
price (float): always be positive to ensure consistency
value (float): (unused) cost incurred in new size/price op
Not used because the value is calculated for the
trade
commission (float): incurred commission in the new size/price op
pnl (float): (unused) generated by the executed part
Not used because the trade has an independent pnl
'''
if not size:
return # empty update, skip all other calculations
# Commission can only increase
self.commission += commission
# Update size and keep a reference for logic an calculations
oldsize = self.size
self.size += size # size will carry the opposite sign if reducing
# Check if it has been currently opened
self.justopened = bool(not oldsize and size)
if self.justopened:
self.baropen = len(self.data)
self.dtopen = 0.0 if order.p.simulated else self.data.datetime[0]
self.long = self.size > 0
# Any size means the trade was opened
self.isopen = bool(self.size)
# Update current trade length
self.barlen = len(self.data) - self.baropen
# record if the position was closed (set to null)
self.isclosed = bool(oldsize and not self.size)
# record last bar for the trade
if self.isclosed:
self.isopen = False
self.barclose = len(self.data)
self.dtclose = self.data.datetime[0]
self.status = self.Closed
elif self.isopen:
self.status = self.Open
if abs(self.size) > abs(oldsize):
# position increased (be it positive or negative)
# update the average price
self.price = (oldsize * self.price + size * price) / self.size
pnl = 0.0
else: # abs(self.size) < abs(oldsize)
# position reduced/closed
pnl = comminfo.profitandloss(-size, self.price, price)
self.pnl += pnl
self.pnlcomm = self.pnl - self.commission
self.value = comminfo.getvaluesize(self.size, self.price)
# Update the history if needed
if self.historyon:
dt0 = self.data.datetime[0] if not order.p.simulated else 0.0
histentry = TradeHistory(
self.status, dt0, self.barlen,
self.size, self.price, self.value,
self.pnl, self.pnlcomm, self.data._tz)
histentry.doupdate(order, size, price, commission)
self.history.append(histentry)
Loading...
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化