Skip to content

历史订单 ​

GET /api/v1.0/sim-trade/{acc_id}/history-orders

获取历史订单(支持时间范围 + 分页)。

请求参数 ​

参数类型位置必填说明
acc_idstringpath是业务账户 ID
marketintquery是账户市场ID(账户列表中该账户的 market_id,如 1=港股 100=美股融资融券),必须与 acc_id 对应账户一致
time_beginint64query否起始时间(Unix 微秒)
time_endint64query否结束时间(Unix 微秒)
page_sizeintquery否分页大小(默认 50)
next_keystringquery否翻页游标

请求示例 ​

bash
curl -s "https://webapi.futunn.com/api/v1.0/sim-trade/80306537/history-orders?market=100&page_size=10" -H "Authorization: Bearer <AccessToken>" | jq

响应字段 ​

订单字段同今日订单,额外包含分页信息:pagination.has_more(bool)、pagination.next_key(string)。

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "orders": [
      {
        "order_id": "1294505",
        "side": 1,
        "market": 2,
        "symbol": "AAPL",
        "stock_name": "Apple",
        "order_type": 1,
        "status": 5,
        "qty": "1",
        "cum_qty": "0",
        "price": "1",
        "avg_fill_price": "0",
        "aux_price": null,
        "time_in_force": 0,
        "order_trade_time_type": 1,
        "create_time": "1794192328000000",
        "update_time": "1794192328000000",
        "text": ""
      }
    ]
  },
  "pagination": {
    "next_key": "0",
    "has_more": false
  }
}

错误响应 ​

HTTP 状态始终为 200。请求失败时返回非 0 的 ret_code 和 error 对象。

json
{
  "ret_code": -3,
  "ret_msg": "invalid request",
  "error": {"code": "invalid_parameter", "message": "invalid request"}
}