## 提示

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


## 原型

```python
debt_to_stock_order(security, amount)
```

## 释义

debt_to_stock_order 是 PTrade 中用于债转股委托的接口。

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

## 参数

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

## 返回值

Order对象中的id或者None。如果创建订单成功，则返回Order对象的id(str)，失败则返回None(NoneType)。

## 示例

```python
def initialize(context):

g.security = "600570.SS"

set_universe(g.security)

def before_trading_start(context, data):

g.count = 0

def handle_data(context, data):

if g.count == 0:

# 对持仓内的国贸转债进行转股操作

debt_to_stock_order("110033.SS", -1000)

g.count += 1

# 查看委托状态

log.info(get_orders())

g.count += 1
```

## 详细说明

debt_to_stock_order(security, amount)

### 使用场景

该函数仅在交易模块可用

### 接口说明

该接口用于可转债转股操作。

### 注意事项

无

### 参数详细说明

security: 可转债代码(str)

amount: 委托数量(int)

### 返回值

Order对象中的id或者None。如果创建订单成功，则返回Order对象的id(str)，失败则返回None(NoneType)。