历史订单
GET/api/v1.0/sim-trade/{acc_id}/history-orders获取历史订单(支持时间范围 + 分页)。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
acc_id | string | path | 是 | 业务账户 ID |
market | int | query | 是 | 账户市场ID(账户列表中该账户的 market_id,如 1=港股 100=美股融资融券),必须与 acc_id 对应账户一致 |
time_begin | int64 | query | 否 | 起始时间(Unix 微秒) |
time_end | int64 | query | 否 | 结束时间(Unix 微秒) |
page_size | int | query | 否 | 分页大小(默认 50) |
next_key | string | query | 否 | 翻页游标 |
请求示例
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"}
}