## 提示

- `live-or-trading-module-only`
- `broker-or-counter-dependent`


## 原型

```python
get_lucky_info(start_date, end_date)
```

## 释义

get_lucky_info 是 PTrade 中用于获取历史中签信息的接口。

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

## 参数

| 参数 | 是否必填 | 官方原始定义 |
|---|---:|---|
| `start_date` | 是 | start_date |
| `end_date` | 是 | end_date |

## 返回值

正常返回一个列表套字典数据，异常或无中签信息时返回一个空列表。

返回的数据格式如下：

[{'stock_code': 证券代码(str), 'occur_amount': 发生数量(float), 'business_price': 成交价格(float), 'stock_name': 证券名称(str), 'init_date': 交易日期(int)}, ...]

[{'stock_code': '371002.SZ', 'occur_amount': 10.0, 'business_price': 100.0, 'stock_name': '崧盛发债', 'init_date': 20220928}, ...]

## 示例

```python
def initialize(context):

# 初始化策略

g.security = "600570.SS"

set_universe(g.security)

def before_trading_start(context, data):

pre_date = str(get_trading_day(-1)).replace("-", "")

current_date = context.blotter.current_dt.strftime("%Y%m%d")

# 获取上一交易日至今天中签信息

lucky_info = get_lucky_info(pre_date, current_date)

log.info(lucky_info)

def handle_data(context, data):

pass

交易相关函数

注意：代码精度位为3位小数的类型(后台已保护为3位)，如ETF、国债；代码精度为2位小数类型，需要在传参时限制价格参数的精度，如股票。

股票交易函数
```

## 详细说明

get_lucky_info(start_date, end_date)

### 使用场景

该函数仅在交易模块使用，对接jz_ufx不支持该函数

### 接口说明

该接口用于获取指定时间范围内的中签信息。

### 注意事项

为减小对柜台压力，该函数在股票交易模块中同一分钟内多次调用返回当前分钟首次查询的缓存数据。

### 参数详细说明

start_date：开始日期(str)，输入形式仅支持"YYYYmmdd"，如"20220928"。

end_date：结束日期(str)，输入形式仅支持"YYYYmmdd"，如"20220929"。

### 返回值

正常返回一个列表套字典数据，异常或无中签信息时返回一个空列表。

返回的数据格式如下：

[{'stock_code': 证券代码(str), 'occur_amount': 发生数量(float), 'business_price': 成交价格(float), 'stock_name': 证券名称(str), 'init_date': 交易日期(int)}, ...]

[{'stock_code': '371002.SZ', 'occur_amount': 10.0, 'business_price': 100.0, 'stock_name': '崧盛发债', 'init_date': 20220928}, ...]