## 提示

- `backtest-only`


## 原型

```python
get_trades_file(save_path='')
```

## 释义

get_trades_file 是 PTrade 中用于获取对账数据文件的接口。

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

## 参数

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

## 返回值

成功返回导出文件的路径(str)，失败返回None(NoneType)；

导出数据格式的说明:

交易数据文件的组织格式为csv文件，表头信息为：

订单编号，成交编号，委托编号，标的代码，交易类型，成交数量，成交价，成交金额，交易费用，交易时间，对应的表头字段为：

[order_id,trading_id,entrust_id,security_code,order_type,volume,price,total_money,trading_fee, trade_time]

## 示例

```python
def initialize(context):

g.security = '600570.SS'

set_universe(g.security)

def handle_data(context, data):

# 委托

order_obj = order(g.security, 100)

log.info('订单编号为：%s'% order_obj)

def after_trading_end(context, data):

# 获取对账数据，存放到默认目录

data_path = get_trades_file()

log.info(data_path)

# 获取对账数据，存放到notebook下的指定目录

user_data_path = get_trades_file('user_data/data')

log.info(user_data_path)
```

## 详细说明

get_trades_file(save_path='')

### 使用场景

该函数仅在回测模块可用

### 接口说明

该接口用于获取对账数据文件

### 注意事项

文件目录的命名需要遵守如下规则：

长度不能超过256个字符。

名称中不能出下如下字符：:?,@#$&();\"\'<>`~!%^*

### 参数详细说明

save_path：导出对账数据存储的路径， 默认在notebook的根目录下(str)；

### 返回值

成功返回导出文件的路径(str)，失败返回None(NoneType)；

导出数据格式的说明:

交易数据文件的组织格式为csv文件，表头信息为：

订单编号，成交编号，委托编号，标的代码，交易类型，成交数量，成交价，成交金额，交易费用，交易时间，对应的表头字段为：

[order_id,trading_id,entrust_id,security_code,order_type,volume,price,total_money,trading_fee, trade_time]

### 注意事项

order_id列中可能出现如下几种取值：

1、M000000，通过外部系统委托的成交数据；

2、类似a6fbc145958843cc86639b23fbcfdc4c的字符串，通过平台委托的成交数据；

3、H000000，引入对账数据接口前的版本产生的交易数据；