## 提示

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


## 原型

```python
order_value(security, value, limit_price=None)
```

## 释义

order_value 是 PTrade 中用于指定目标价值买卖的接口。

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

## 参数

| 参数 | 是否必填 | 官方原始定义 |
|---|---:|---|
| `security` | 是 | security |
| `value` | 是 | value |
| `limit_price` | 否 | limit_price=None |

## 返回值

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

## 示例

```python
def initialize(context):

g.security = ['600570.SS', '000001.SZ']

set_universe(g.security)

def handle_data(context, data):

#买入价值为10000元的恒生电子股票

order_value('600570.SS', 10000)

if data['600570.SS']['close'] > 39:

#卖出价值为10000元的恒生电子股票

order_value('600570.SS', -10000)
```

## 详细说明

order_value(security, value, limit_price=None)

### 使用场景

该函数仅在回测、交易模块可用

### 接口说明

该接口用于买卖指定价值为value的股票

### 注意事项

该函数不支持逆回购交易。

该函数在委托股票时取整100股，委托可转债时取整10张。

交易场景如果limit_price字段不入参，系统会默认用行情快照数据最新价报单，假如行情快照获取失败会导致委托失败，系统会在日志中增加提醒。

### 参数详细说明

security：股票代码(str)；

value：股票价值(float)

limit_price：买卖限价(float)

### 返回值

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