## 提示

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


## 原型

```python
get_orders(security=None)
```

## 释义

get_orders 是 PTrade 中用于获取全部订单的接口。

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

## 参数

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

## 返回值

返回一个list，该list中包含多个Order对象(list[Order,...])。

[<Order {'id': '52e6a3f8a2b7468e92258c52dfcb6d42', 'dt': datetime.datetime(2025, 2, 21, 11, 25, 1, 229575), 'priceGear': 0, 'limit': 34.1, 'symbol': '600570.XSHG', 'amount': 1000, 'created': datetime.datetime(2025, 2, 21, 11, 25, 1, 229575), 'filled': 0, 'status': '2', 'entrust_no': '3596', 'cancel_entrust_no': None}>]

## 示例

```python
def initialize(context):

g.security = '600570.SS'

set_universe(g.security)

def handle_data(context, data):

_id = order(g.security, 100)

order_obj = get_orders()

log.info(order_obj)
```

## 详细说明

get_orders(security=None)

### 使用场景

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

### 接口说明

该接口用于获取策略内所有订单，或按条件获取指定订单。

### 注意事项

无

### 参数详细说明

security：标的代码，如'600570.SS'，不传时默认为获取所有订单(str)；

### 返回值

返回一个list，该list中包含多个Order对象(list[Order,...])。

[<Order {'id': '52e6a3f8a2b7468e92258c52dfcb6d42', 'dt': datetime.datetime(2025, 2, 21, 11, 25, 1, 229575), 'priceGear': 0, 'limit': 34.1, 'symbol': '600570.XSHG', 'amount': 1000, 'created': datetime.datetime(2025, 2, 21, 11, 25, 1, 229575), 'filled': 0, 'status': '2', 'entrust_no': '3596', 'cancel_entrust_no': None}>]