交易管理

交易管理可理解为一个模拟账户进行模拟交易。一般使用 crtTM 创建交易管理实例。

公共参数:

  • reinvest=False (bool) : 红利是否再投资
  • precision=2 (int) : 价格计算精度
  • support_borrow_cash=False (bool) : 是否自动融资
  • support_borrow_stock=False (bool) : 是否自动融券
  • save_action=True (bool) : 是否保存Python命令序列
hikyuu.trade_manage.crtTM([datetime = Datetime(199001010000), initcash = 100000, costfunc = TC_Zero(), name = "SYS"])

创建交易管理模块,管理帐户的交易记录及资金使用情况

Parameters:
  • datetime (Datetime) – 账户建立日期
  • initcash (float) – 初始资金
  • costfunc (TradeCost) – 交易成本算法
  • name (string) – 账户名称
Return type:

TradeManager

class hikyuu.trade_manage.TradeManager

交易管理类,可理解为一个模拟账户进行模拟交易。一般使用 crtTM 创建交易管理实例。

name

名称

costFunc

交易成本算法

initCash

(只读)初始资金

initDatetime

(只读)账户建立日期

firstDatetime

(只读)第一笔买入交易发生日期,如未发生交易返回Null<Datetime>()

lastDatetime

(只读)最后一笔交易日期,注意和交易类型无关,如未发生交易返回账户建立日期

reinvest

(只读)红利/股息/送股再投资标志,同公共参数“reinvest”

precision

(只读)价格精度,同公共参数“precision”

brokeLastDatetime

实际开始订单代理操作的时刻。

默认情况下,TradeManager会在执行买入/卖出操作时,调用订单代理执行代理的买入/卖出动作,但这样在实盘操作时会存在问题。因为系统在计算信号指示时,需要回溯历史数据才能得到最新的信号,这样TradeManager会在历史时刻就执行买入/卖出操作,此时如果订单代理本身没有对发出买入/卖出指令的时刻进行控制,会导致代理发送错误的指令。此时,需要指定在某一个时刻之后,才允许指定订单代理的买入/卖出操作。属性 brokeLastDatetime 即用于指定该时刻。

__init__(self, datetime, initcash, costfunc, name)

初始化构造函数

Parameters:
  • datetime (Datetime) – 账户建立日期
  • initCash (float) – 初始资金
  • costFunc (TradeCostBase) – 成本算法
  • name (str) – 账户名称
getParam(self, name)

获取指定的参数

Parameters:name (str) – 参数名称
Returns:参数值
Raises:out_of_range – 无此参数
setParam(self, name, value)

设置参数

Parameters:
  • name (str) – 参数名称
  • value (int | bool | float | string) – 参数值
Raises:

logic_error – Unsupported type! 不支持的参数类型

reset(self)

复位,清空交易、持仓记录

clone(self)

克隆(深复制)实例

Return type:TradeManager
checkin(self, datetime, cash)

向账户内存入现金

Parameters:
  • datetime (Datetime) – 交易时间
  • cash (float) – 存入的现金量
Return type:

TradeRecord

checkout(self, datetime, cash)

从账户内取出现金

Parameters:
  • datetime (Datetime) – 交易时间
  • cash (float) – 取出的资金量
Return type:

TradeRecord

buy(self, datetime, stock, realPrice, number[, stoploss=0.0, goalPrice=0.0, planPrice=0.0, part=System.INVALID])

买入操作

Parameters:
  • datetime (Datetime) – 买入时间
  • stock (Stock) – 买入的证券
  • realPrice (float) – 实际买入价格
  • num (int) – 买入数量
  • stoploss (float) – 止损价
  • goalPrice (float) – 目标价格
  • planPrice (float) – 计划买入价格
  • part (SystemPart) – 交易指示来源
Return type:

TradeRecord

sell(self, datetime, stock, realPrice[, number=Constant.null_size, stoploss=0.0, goalPrice=0.0, planPrice=0.0, part=System.INVALID])

卖出操作

Parameters:
  • datetime (Datetime) – 卖出时间
  • stock (Stock) – 卖出的证券
  • realPrice (float) – 实际卖出价格
  • num (int) – 卖出数量,如果等于Constant.null_size,表示全部卖出
  • stoploss (float) – 新的止损价
  • goalPrice (float) – 新的目标价格
  • planPrice (float) – 原计划卖出价格
  • part (SystemPart) – 交易指示来源
Return type:

TradeRecord

have(self, stock)

当前是否持有指定的证券

Parameters:stock (Stock) – 指定证券
Return type:bool
cash(self, datetime[, ktype=KQuery.KType.DAY])

获取指定日期的现金。(注:如果不带日期参数,无法根据权息信息调整持仓。)

Parameters:
  • datetime (Datetime) – 指定时刻
  • ktype – K线类型
Return type:

float

getStockNumber(self)

当前持有的证券种类数量,即当前持有几只股票(非各个股票的持仓数)

Return type:int
getHoldNumber(self, datetime, stock)

获取指定时刻指定证券的持有数量

Parameters:
  • datetime (Datetime) – 指定时刻
  • stock (Stock) – 指定的证券
Return type:

int

getPosition(self, stock)

获取指定证券的当前持仓记录,如当前未持有该票,返回PositionRecord()

Parameters:stock (Stock) – 指定的证券
Return type:PositionRecord
getTradeList(self)

获取全部交易记录

Return type:TradeRecordList
getPositionList(self)

获取当前全部持仓记录

Return type:PositionRecordList
getHistoryPositionList(self)

获取全部历史持仓记录,即已平仓记录

Return type:PositionRecordList
getBuyCost(self, datetime, stock, price, num)

计算买入成本

Parameters:
  • datetime (Datetime) – 交易时间
  • stock (Stock) – 交易的证券
  • price (float) – 买入价格
  • num (int) – 买入数量
Return type:

CostRecord

getSellCost(self, datetime, stock, price, num)

计算卖出成本

Parameters:
  • datetime (Datetime) – 交易时间
  • stock (Stock) – 交易的证券
  • price (float) – 卖出价格
  • num (int) – 卖出数量
Return type:

CostRecord

getFunds(self[, ktype = KQuery.DAY])

获取账户当前时刻的资产详情

Parameters:ktype (KQuery.KType) – K线类型
Return type:FundsRecord
getFunds(self, datetime[, ktype = KQuery.DAY])

获取指定时刻的资产市值详情

Parameters:
Return type:

FundsRecord

getFundsCurve(self, dates[, ktype = KQuery.DAY])

获取资产净值曲线

Parameters:
  • dates (DatetimeList) – 日期列表,根据该日期列表获取其对应的资产净值曲线
  • ktype (KQuery.KType) – K线类型,必须与日期列表匹配
Returns:

资产净值列表

Return type:

PriceList

getProfitCurve(self, dates[, ktype = KQuery.DAY])

获取收益曲线,即扣除历次存入资金后的资产净值曲线

Parameters:
  • dates (DatetimeList) – 日期列表,根据该日期列表获取其对应的收益曲线,应为递增顺序
  • ktype (KQuery.KType) – K线类型,必须与日期列表匹配
Returns:

收益曲线

Return type:

PriceList

tocsv(self, path)

以csv格式输出交易记录、未平仓记录、已平仓记录、资产净值曲线

Parameters:path (str) – 输出文件所在目录
regBroker(self, broker)

注册订单代理。可执行多次该命令注册多个订单代理。

Parameters:broker (OrderBrokerBase) – 订单代理实例
clearBroker(self)

清空所有已注册订单代理