获取历史成交

GET /api/v1/crypto/accounts/{acc_id}/fills/history

按时间范围查询历史成交记录。查询区间不得超过 三个月。

路径参数

参数	类型	必填	说明
acc_id	uint64	是	账户 ID

请求参数

参数	类型	位置	必填	说明
start_time	int64	查询	是	开始时间（Unix 微秒时间戳）
end_time	int64	查询	是	结束时间（Unix 微秒时间戳）
page_size	uint32	查询	否	每页条数，最大 50，默认 50
page_flag	string	查询	否	翻页游标，首次请求不传
symbol	string	查询	否	交易对筛选，如 BTCUSD

响应参数

字段	类型	说明
fills	list[FillItem]	成交列表
page_flag	string	下次请求的翻页游标
completed	bool	为 true 表示所有数据已返回，客户端应停止翻页请求

请求示例

curl -X GET "https://webapi.futunn.com/api/v1/crypto/accounts/123456/fills/history?start_time=1750000000000000&end_time=1750086400000000&symbol=BTCUSD" \
  -H "X-Api-Key: <AppKey>" \
  -H "X-Timestamp: <timestamp_ms>" \
  -H "X-Nonce: <nonce>" \
  -H "Authorization: <signature_base64>"

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "fills": [
      {
        "order_id": "FTHC2989880641155745280T",
        "fill_id": "FILL-001",
        "symbol_pair": { "symbol": "BTCUSD", "base": "BTC", "quote": "USD" },
        "side": "BUY",
        "quantity": "0.01",
        "price": "30000",
        "amount": "300.00",
        "fill_time": 1750000050000000
      }
    ],
    "page_flag": "",
    "completed": true
  }
}

失败响应：

{
  "code": 1,
  "msg": "Error Message."
}