Skip to content

下单 ​

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

模拟交易下单。数量和价格均为字符串;限价单必须传 price,市价单可不传。下单不幂等:超时或结果未知时先查今日订单,避免重复下单。服务端未建单时(如 market 与账户不符)返回 -5 backend_biz_error。

请求参数 ​

参数类型位置必填说明
acc_idstringpath是业务账户 ID
marketintbody是账户市场ID(账户列表中该账户的 market_id,如 1=港股 100=美股融资融券),必须与 acc_id 对应账户一致
symbolstringbody是证券代码,支持 MARKET.CODE(如 US.AAPL、US.AAPL261120C275000)或不带前缀的代码
order_typeintbody是订单类型:1=限价 3=市价
order_sideintbody是买卖方向:1=买入 2=卖出
qtystringbody是数量
pricestringbody否委托价格(限价单必填;市价单可不传)
textstringbody否备注(≤100 字节)
order_trade_time_typeintbody否交易时段:0=未设置 1=仅盘中 2=含盘前盘后(美股融资融券账户支持)

请求示例 ​

bash
curl -s -X POST "https://webapi.futunn.com/api/v1.0/sim-trade/80306537/orders" \
  -H "Authorization: Bearer <AccessToken>" \
  -H "Content-Type: application/json" \
  -d '{"market":100,"symbol":"US.AAPL","order_type":1,"order_side":1,"qty":"1","price":"1","order_trade_time_type":1}' | jq

响应字段 ​

字段类型说明
order_idstring订单 ID

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "order_id": "1294505"
  }
}

错误响应 ​

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

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

服务端未建单时(如 market 与账户不符)同样按失败返回:

json
{
  "ret_code": -5,
  "ret_msg": "backend business error",
  "error": {"code": "backend_biz_error", "message": "backend business error"}
}