## 提示

- `live-or-trading-module-only`


## 原型

```python
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)；

## 示例

```python
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；

### 返回值

入参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)；

start_index: 分笔关联的逐笔开始序号(int)(行情暂不支持，返回均为0)；

end_index: 分笔关联的逐笔结束序号(int)(行情暂不支持，返回均为0)；