get_tick_direction - 获取分时成交行情

get_tick_direction 是 PTrade 中用于获取分时成交行情的接口。

提示

live-or-trading-module-only

原型

get_tick_direction(symbols=None, query_date=0, start_pos=0, search_direction=1, data_count=50, is_dict=False)

释义

get_tick_direction 是 PTrade 中用于获取分时成交行情的接口。

研究：不支持；回测：不支持；模拟：官方目录未明确；实盘：支持。

参数

参数	是否必填	官方原始定义
`symbols`	否	symbols=None
`query_date`	否	query_date=0
`start_pos`	否	start_pos=0
`search_direction`	否	search_direction=1
`data_count`	否	data_count=50
`is_dict`	否	is_dict=False

返回值

入参is_dict为True时返回dict类型，为False(默认)时返回OrderedDict类型。

dict类型

返回的数据格式如下：

{股票代码(str): [[时间戳毫秒级(int), 价格(float), 价格(int), 成交数量(int), 成交金额(int), 成交笔数(int), 成交方向(int), 持仓量(int), 分笔关联的逐笔开始序号(int), 分笔关联的逐笔结束序号(int)], ...], "fields": ["time_stamp", "hq_px", "hq_px64", "business_amount", "business_balance", "business_count", "business_direction", "amount", "start_index", "end_index"]}

{"600570.SS": [[20220915132138000, 36.18, 0, 2600, 94062, 6, 1, 0, 0, 0], "fields": ["time_stamp", "hq_px", "hq_px64", "business_amount", "business_balance", "business_count", "business_direction", "amount", "start_index", "end_index"]}

OrderedDict类型

返回结果字段介绍：

time_stamp: 时间戳毫秒级(int)；

hq_px: 价格(float)；

hq_px64: 价格(int)(行情暂不支持，返回均为0)；

business_amount: 成交数量(int)；

business_balance: 成交金额(int)；

business_count: 成交笔数(int)；

business_direction: 成交方向(int)；

amount: 持仓量(int)(行情暂不支持，返回均为0)；

示例

def initialize(context):

g.security = "600570.SS"

set_universe(g.security)

def handle_data(context, data):

# 获取分时成交数据

direction_data = get_tick_direction([g.security])

log.info(direction_data)

# 获取成交量

business_amount = direction_data[g.security]["business_amount"]

log.info("分时成交的成交量为：%s" % business_amount)

# 返回字典类型数据

# 获取字典类型分时成交数据

direction_data = get_tick_direction([g.security], is_dict=True)

log.info(direction_data)

详细说明

get_tick_direction(symbols=None, query_date=0, start_pos=0, search_direction=1, data_count=50, is_dict=False)

使用场景

该函数在交易模块可用

接口说明

该接口用于获取当日分时成交行情数据。

注意事项

沪深市场都有分时成交数据。

当策略入参is_dict为True时返回的数据类型为dict，返回dict类型数据的速度比OrderedDict类型数据有提升。

参数详细说明

symbols: 单只标的代码(str)或代码列表(list[str])；

query_date: 查询日期，默认为0，返回当日日期数据(目前行情只支持查询当日的数据，格式为YYYYMMDD)(int)；

start_pos: 起始位置，默认为0(int)；

search_direction: 搜索方向(1向前，2向后)，默认为1(int)；

data_count: 数据条数，默认为50，最大为200(int)；

is_dict: 返回类型（False-OrderedDict; True-dict），默认为False；

返回值