今日订单
GET/api/v1.0/sim-trade/{acc_id}/orders获取今日订单列表。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
acc_id | string | path | 是 | 业务账户 ID |
market | int | query | 是 | 账户市场ID(账户列表中该账户的 market_id,如 1=港股 100=美股融资融券),必须与 acc_id 对应账户一致 |
请求示例
bash
curl -s "https://webapi.futunn.com/api/v1.0/sim-trade/80306537/orders?market=100" -H "Authorization: Bearer <AccessToken>" | jq响应字段
返回 data.orders[]。
| 字段 | 类型 | 说明 |
|---|---|---|
order_id | string | 订单号 |
side | int | 买卖方向:1=买入 2=卖出 3=卖空 4=买回(按服务端记录返回) |
market | int/null | 订单所属交易品种市场(Market 枚举:1=港股 2=美股 3=美股期权 4=港股通),与账户 market_id 不是同一套编号;美股融资融券账户的正股与期权订单均为 2;部分账户不返回时为 null |
symbol | string | 证券代码(不带市场前缀,如 AAPL、AAPL261120C275000、00700) |
stock_name | string | 名称 |
order_type | int | 订单类型:1=限价单 3=市价单 |
status | int | 订单状态:1=待提交 2=已提交 3=部分成交 4=全部成交 5=已撤销 6=已拒绝 7=部分成交已撤销 |
qty | string | 委托量 |
cum_qty | string | 已成交量 |
price | string | 委托价 |
avg_fill_price | string | 成交均价 |
aux_price | string/null | 止损触发价(无时为 null) |
time_in_force | int/null | 订单期限:0=当日有效 1=撤单前有效(GTC);部分账户不返回时为 null |
order_trade_time_type | int/null | 交易时段:0=未设置 1=仅盘中 2=含盘前盘后;部分账户不返回时为 null |
create_time | string | 创建时间(Unix 微秒,字符串) |
update_time | string | 更新时间(Unix 微秒,字符串) |
text | 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": ""
}
]
}
}错误响应
HTTP 状态始终为 200。请求失败时返回非 0 的 ret_code 和 error 对象。
json
{
"ret_code": -3,
"ret_msg": "invalid request",
"error": {"code": "invalid_parameter", "message": "invalid request"}
}