## 提示

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


## 原型

```python
ipo_stocks_order(submarket_type=None, black_stocks=None)
```

## 释义

ipo_stocks_order 是 PTrade 中用于新股一键申购的接口。

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

## 参数

| 参数 | 是否必填 | 官方原始定义 |
|---|---:|---|
| `submarket_type` | 否 | submarket_type=None |
| `black_stocks` | 否 | black_stocks=None |

## 返回值

返回dict类型，包含委托代码、委托编号、委托状态(委托失败为0，委托成功为1)、委托数量等信息(dict[str:dict[str:str,str:int,str:float],...])

{'732116.SS': {'entrust_no': '205001', 'entrust_status': 1, 'redemption_amount': 1000}, '732100.SS': {'entrust_no': '205002', 'entrust_status': 1, 'redemption_amount': 2000}}

## 示例

```python
import time

def initialize(context):

g.security = "600570.SS"

set_universe(g.security)

g.flag = False

def before_trading_start(context, data):

g.flag = False

def handle_data(context, data):

if not g.flag:

# 上证普通代码

log.info("申购上证普通代码：")

ipo_stocks_order(submarket_type=0)

time.sleep(5)

# 上证科创板代码

log.info("申购上证科创板代码：")

ipo_stocks_order(submarket_type=1)

time.sleep(5)

# 深证普通代码

log.info("申购深证普通代码：")

ipo_stocks_order(submarket_type=2)

time.sleep(5)

# 深证创业板代码

log.info("申购深证创业板代码：")

ipo_stocks_order(submarket_type=3)

time.sleep(5)

# 可转债代码

log.info("申购可转债代码：")

ipo_stocks_order(submarket_type=4)

time.sleep(5)

g.flag = True
```

## 详细说明

ipo_stocks_order(submarket_type=None, black_stocks=None)

### 使用场景

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

### 接口说明

该接口用于一键申购当日全部新股

### 注意事项

申购黑名单的股票代码必须为申购代码，代码可以是6位数(不带尾缀)，也可以带尾缀入参,比如：black_stocks='787001'或black_stocks='787001.SS'。

### 参数详细说明

submarket_type：申购代码所属市场，不传时默认申购全部新股(int)；

black_stocks：黑名单股票，可以是单个股票或者股票列表，传入的黑名单股票将不做申购，不传时默认申购全部新股(str/list)；

### 返回值

返回dict类型，包含委托代码、委托编号、委托状态(委托失败为0，委托成功为1)、委托数量等信息(dict[str:dict[str:str,str:int,str:float],...])

{'732116.SS': {'entrust_no': '205001', 'entrust_status': 1, 'redemption_amount': 1000}, '732100.SS': {'entrust_no': '205002', 'entrust_status': 1, 'redemption_amount': 2000}}