获取历史成交

GET /api/v1.0/accounts/{acc_id}/fills_history

查询指定交易业务账户的历史成交列表。

注意

暂不支持查询外汇订单的历史成交。

路径参数

参数	类型	必填	说明
acc_id	string	是	业务账户 ID。

请求参数

参数	类型	位置	必填	说明
trd_market	string	查询	是	交易市场。可选值参见 命名词典
code	string	查询	否	代码筛选。返回指定代码的数据，默认返回全部数据。
start	uint64	查询	否	更新时间的起始时间，时间戳，单位微秒。
end	uint64	查询	否	更新时间的结束时间，应在起始时间之后。时间戳，单位微秒。
page_flag	string	查询	否	翻页标记。首次请求可不传（或传空字符串）表示从头开始，之后填入服务端返回的 page_flag。
page_size	uint32	查询	否	每页条数。不传默认 50；传入时不得超过 50。

start 和 end 的组合说明：

start	end	说明
>0	>0	start 和 end 分别为微秒时间戳，不是日历日期。
0	>0	start 为 end 之前 90 天。
>0	0	end 为 start 之后 90 天。
0	0	start 为当前时刻之前 90 天，end 为当前时刻。

响应参数

字段	类型	说明
order_fills	list[order_fill]	成交列表，默认每次返回 50 条，最新成交在前。
page_flag	string	下次请求的翻页标记
completed	bool	为 true 表示所有成交记录已返回，客户端应停止翻页请求。

响应示例

{
  "s": "ok",
  "d": {
    "order_fills": [
      {
        "trd_side": "BUY",
        "deal_id": "F2024030100000001",
        "order_id": "2024030100000001",
        "code": "US.AAPL",
        "stock_name": "Apple Inc.",
        "qty": "100",
        "price": "180.000",
        "create_time": 1709251210000000,
        "update_time": 1709251210000000,
        "counter_broker_id": "9999",
        "counter_broker_name": "Goldman Sachs",
        "status": "OK"
      }
    ],
    "page_flag": "",
    "completed": true
  }
}