Skip to content

今日订单 ​

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

获取今日订单列表。

请求参数 ​

参数类型位置必填说明
acc_idstringpath是业务账户 ID
marketintquery是账户市场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_idstring订单号
sideint买卖方向:1=买入 2=卖出 3=卖空 4=买回(按服务端记录返回)
marketint/null订单所属交易品种市场(Market 枚举:1=港股 2=美股 3=美股期权 4=港股通),与账户 market_id 不是同一套编号;美股融资融券账户的正股与期权订单均为 2;部分账户不返回时为 null
symbolstring证券代码(不带市场前缀,如 AAPL、AAPL261120C275000、00700)
stock_namestring名称
order_typeint订单类型:1=限价单 3=市价单
statusint订单状态:1=待提交 2=已提交 3=部分成交 4=全部成交 5=已撤销 6=已拒绝 7=部分成交已撤销
qtystring委托量
cum_qtystring已成交量
pricestring委托价
avg_fill_pricestring成交均价
aux_pricestring/null止损触发价(无时为 null)
time_in_forceint/null订单期限:0=当日有效 1=撤单前有效(GTC);部分账户不返回时为 null
order_trade_time_typeint/null交易时段:0=未设置 1=仅盘中 2=含盘前盘后;部分账户不返回时为 null
create_timestring创建时间(Unix 微秒,字符串)
update_timestring更新时间(Unix 微秒,字符串)
textstring备注

响应示例 ​

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"}
}