## 提示

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


## 原型

```python
get_trades()
```

## 释义

get_trades 是 PTrade 中用于获取当日成交订单的接口。

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

## 参数

官方结构化目录未列出独立参数。请以本页函数签名和下方官方原文为准。

## 返回值

返回数据：

一个订单编号一笔成交：{'订单编号': [[]]} (dict{str: list[list[]]})

一个订单编号多笔成交：{'订单编号': [[], [], ...]} (dict{str: list[list[], list[], ...]})

股票返回字段：{'订单编号': [[成交编号, 委托编号, 标的代码, 买卖类型, 成交数量, 成交价格, 成交金额, 成交时间]]}

期货返回字段：{'订单编号': [[成交编号, 委托编号, 标的代码, 买卖类型, 开平仓类型, 成交数量, 成交价格, 成交金额, 成交时间]]}

成交编号：str类型

委托编号：str类型

标的代码：str类型

买卖类型：str类型

开平仓类型：开仓、平仓、平今仓，仅支持衍生品业务，str类型

成交数量：float类型

成交价格：float类型

成交金额：float类型

成交时间：YYYY-mm-dd HH:MM:SS格式，str类型

示例如下(股票)：

## 示例

```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:

# 按照回购利率1.76委托国债逆回购

order("204001.SS", -1000, 1.76)

g.count += 1

log.info(get_trades())

融资融券专用函数

融资融券交易类函数
```

## 详细说明

get_trades()

### 使用场景

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

### 接口说明

该接口用于获取策略内当日已成交订单详情。

### 注意事项

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

该接口会返回当日截止到当前时间段内的成交数据。

一个订单编号会对应一笔或多笔成交记录。

不同品种返回字段不同。

股票标的代码尾缀为四位，上证为XSHG，深圳为XSHE，如需对应到代码请做代码尾缀兼容。

获取国债逆回购成交详情时，成交价格字段实际为回购利率。

### 参数详细说明

无

### 返回值

返回数据：

一个订单编号一笔成交：{'订单编号': [[]]} (dict{str: list[list[]]})

一个订单编号多笔成交：{'订单编号': [[], [], ...]} (dict{str: list[list[], list[], ...]})

股票返回字段：{'订单编号': [[成交编号, 委托编号, 标的代码, 买卖类型, 成交数量, 成交价格, 成交金额, 成交时间]]}

期货返回字段：{'订单编号': [[成交编号, 委托编号, 标的代码, 买卖类型, 开平仓类型, 成交数量, 成交价格, 成交金额, 成交时间]]}

成交编号：str类型

委托编号：str类型

标的代码：str类型

买卖类型：str类型

开平仓类型：开仓、平仓、平今仓，仅支持衍生品业务，str类型

成交数量：float类型

成交价格：float类型

成交金额：float类型

成交时间：YYYY-mm-dd HH:MM:SS格式，str类型

示例如下(股票)：

{'ba6a80d9746347a99c050b29069807c7': [['5001', '700001', '600570.XSHG', '买', 100000.0, 86.60, 8660000.0, '2021-08-15 09:32:00']]}