Skip to content

改单 ​

PUT /api/v1.0/accounts/{acc_id}/orders/{order_id}

修改已有订单。

注意

不支持修改 A 股订单。

路径参数 ​

参数类型必填说明
acc_idstring是业务账户 ID。
order_idstring是订单 ID。

请求参数 ​

参数类型位置必填说明
exchangeExchange请求体是交易所。可选值参见命名词典 - exchange。
qtystring请求体是修改后的订单数量。期权和期货的单位为"合约"。
pricestring请求体是修改后的价格。期货精确到 9 位小数,其他标的精确到 4 位小数,超出部分将被截断。
aux_pricestring请求体否触发价格。当订单类型为 STOP、STOP_LIMIT、MARKET_IF_TOUCHED、LIMIT_IF_TOUCHED 时必填。证券账户精确到 3 位小数,期货精确到 9 位小数。

请求示例 ​

bash
curl -X PUT 'https://webapi.futunn.com/api/v1.0/accounts/{acc_id}/orders/{order_id}' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <AccessToken>' \
  -d '{
    "exchange": "US",
    "qty": "200",
    "price": "155.00"
  }' | jq

响应示例 ​

json
{
  "s": "ok"
}

失败响应:

普通错误:

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

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

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

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

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

提示

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