下单

POST /api/v1.0/accounts/{acc_id}/orders

提交新的交易订单。

路径参数

参数	类型	必填	说明
acc_id	string	是	业务账户 ID。

请求参数

参数	类型	位置	必填	说明
code	string	请求体	是	可交易标的代码。格式：market.symbol，例如 US.AAPL，US.AAPL250926C235000
qty	string	请求体	是	订单数量。期权和期货的单位为"合约"。
price	string	请求体	否	订单价格。证券账户精确到 4 位小数（期货精确到 9 位小数），超出部分四舍五入。
side	string	请求体	是	交易方向。可选值：BUY、SELL、SELL_SHORT、BUY_BACK
order_type	string	请求体	是	订单类型。可选值：LIMIT、MARKET、AUCTION、AUCTION_LIMIT、STOP、STOP_LIMIT、MARKET_IF_TOUCHED、LIMIT_IF_TOUCHED
time_in_force	string	请求体	是	有效期。可选值：DAY（当日有效）、GTC（撤单前有效）
session	string	请求体	否	交易时段（仅适用于美股）。可选值：RTH（常规交易时段）、RTH+Pre/Post-Mkt（盘前盘后）、OVERNIGHT（夜间交易）、ALL_DAY（全日交易）。市价单仅支持 RTH。
aux_price	string	请求体	否	触发价格。当订单类型为 STOP、STOP_LIMIT、MARKET_IF_TOUCHED、LIMIT_IF_TOUCHED 时必填。证券账户精确到 3 位小数，期货精确到 9 位小数。
lot_type	string	请求体	否	手数类型，默认整手。适用于港股交易。
remark	string	请求体	否	备注，UTF-8 编码后最大长度 64 字节。
order_class	string	请求体	否	订单类别。多腿订单需指定为 MLEG。
multi_leg_info	MultiLegInfo	请求体	否	多腿订单信息，下多腿订单时必填。

请求示例

curl -X POST 'https://webapi.futunn.com/api/v1.0/accounts/{acc_id}/orders' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <AccessToken>' \
  -d '{
    "code": "US.AAPL",
    "qty": "100",
    "price": "150.00",
    "side": "BUY",
    "order_type": "LIMIT",
    "time_in_force": "DAY"
  }' | jq

响应示例

{
  "s": "ok",
  "d": {
    "order_id": "New order identifier."
  }
}

失败响应：

普通错误：

{
  "s": "error",
  "errcode": -1200,
  "errmsg": "Error message."
}

特殊场景 - 需要二次确认：

{
  "s": "error",
  "errcode": -2100,
  "errmsg": "Order confirmation required.",
  "need_order_confirm": true,
  "confirm_id": "a confirm id"
}

特殊场景 - 需要打开网页：

{
  "s": "error",
  "errcode": -2101,
  "errmsg": "Action required in browser.",
  "need_order_confirm": false,
  "jump_url": "a jump url"
}

提示

• 当响应中 need_order_confirm 为 true 时，需调用二次确认接口完成订单确认。
• 当响应中包含 jump_url 时，请在浏览器中打开该链接完成后续操作。