跳到主要内容

修改订单

接口说明​

  • 功能说明：修改订单。

  • 注意事项：修改订单前必须已经成功调用了下单接口。

  • 适用对象：通过OpenApi开发平台对接webull的客户。

  • 请求URL：/trade/order/replace

  • 请求方式：POST

  • 频次限制：每个AppId调用频次限制为1秒1次。

请求参数​

注：只允许修改数量和价格(不需修改的数量与价格字段则传原值)，其他参数需与原订单相同，需传但不能改

参数类型是否必填描述示例值
account_idString是账户id20150320010101001
stock_order{}stock_order是股票下单参数见示例代码

stock_order:

参数类型是否必填描述示例值
client_order_idString是第三方订单ID，和账户id组成唯一，此字段入参长度最长为40 ，必传不允许修改2022021819071234
sideString是买卖方向，参考字典值 OrderSide，本期只支持BUY和SELL ，必传不允许修改BUY
tifString是订单有效期，参考字典值OrderTIF，当前只支持传 DAY ，必传不允许修改DAY
extended_hours_tradingBoolean是是否允许盘前盘后交易。 市价单只能是false; 限价单可以是true或者false ，必传不允许修改false
instrument_idString是资产标的id，调用者通过调用Get Instruments获取，必传不允许修改12064446
order_typeString是订单类型，参考字典值OrderType ，必传不允许修改MARKET
limit_priceString否order_type为 LIMIT(限价单)、STOP_LOSS_LIMIT(止损限价单)、ENHANCED_LIMIT(增强限价单)、AT_AUCTION_LIMIT(竞价限价盘)需要传。 不改则带原值,需要修改则传改后的值100.49
qtyString是标的数量，整数，支持的最大值为1000000股，不需要修改则带原值,需要修改则传改后的值100
stop_priceString否order_type为 STOP_LOSS(止损单)、STOP_LOSS_LIMIT(止损限价)时，需要传，不需要修改则带原值,需要修改则传改后的值100.49
trailing_typeString否跟踪止损单的价差类型，跟踪止损单要传，参考 TrailingType ，不允许修改AMOUNT
trailing_stop_stepString否跟踪止损单的价差数值，跟踪止损单要传，不需要修改则带原值,需要修改则传改后的值100.49

响应参数​

参数类型描述示例值
client_order_idString第三方订单ID2022021819071234

请求示例​

from webullsdktrade.api import API
from webullsdkcore.client import ApiClient
from webullsdkcore.common.region import Region

api_client = ApiClient(your_app_key, your_app_secret, Region.HK.value)
api = API(api_client)
response = api.order.replace_order(account_id, qty, instrument_id, side, client_order_id, order_type,
                    extended_hours_trading, tif, limit_price, stop_price,
                    trailing_type, trailing_stop_step)
if response.status_code == 200:
    order_res = response.json()

响应示例​

{
    "code": 200,
    "msg": "ok",
    "data": {
        "client_order_id": "01916462123512190"
    }
}

异常示例​

{
    "error_code": "TRADE_WEBULL_REQUEST_PROCESSING",
    "message": "The order is processing, please try later"
}