Modify Order (修改订单)

PUT

/v1/whaleapi/trade/order

Trade

该接口用于对已存在的未成交或部分成交订单进行修改操作。通过传入证券账号 account_no、订单编号 order_id 及需要修改的字段（包括订单数量 quantity、价格 price、触发价格 trigger_price 等），完成订单信息的更新。改单操作仅支持处于可改单状态的订单（如已报、待成交等），改单成功后订单号不变。

This interface is used to modify an existing unfilled or partially filled order. By providing the account number account_no, order ID order_id, and the fields to be updated (such as quantity quantity, price price, and trigger price trigger_price), it updates the order information. Modification is only supported for orders in a modifiable state (e.g., submitted or pending). Upon successful modification, the order ID remains unchanged.

Request

Authorization

Body Params application/json

order_id

string

required

Order ID (订单 ID)

price

string

optional

Modified Order Price (改单价格)

Example:

88.5

quantity

string

required

Modified Order Quantity (改单数量)

Example:

100

trigger_price

string

optional

Trigger Price (触发价格，LIT / MIT 订单必填)

Example:

388.5

trailing_amount

string

optional

Trailing Amount (跟踪金额，TSLPAMT 订单必填)

trailing_percent

string

optional

Trailing Percent (跟踪涨跌幅，单位为百分比，例如 "2.5" 表示 "2.5%"，TSLPPCT 订单必填)

limit_offset

string

optional

Order Target Price Spread (指定价差)

remark

string

optional

Remark (备注)

<= 64 characters

account_no

string

required

Account Number（证券账号）

Example:

L6VQEU00121996

limit_depth_level

number

required

Specifies the bid/ask depth level（指定买卖档位）

monitor_price

string

required

Monitoring price（监控价格）

trigger_count

number

required

Number of triggers（触发次数）

Example

{
  "order_id": "string",
  "price": "88.5",
  "quantity": "100",
  "trigger_price": "388.5",
  "trailing_amount": "string",
  "trailing_percent": "string",
  "limit_offset": "string",
  "remark": "string",
  "account_no": "L6VQEU00121996",
  "limit_depth_level": 0,
  "monitor_price": "string",
  "trigger_count": 0
}

Responses

🟢200OK

*/*

success

Body

code

integer <int32>

required

状态码

message

string

required

错误信息

data

object

required

Example

{
  "code": 0,
  "message": "string",
  "data": {}
}

🟠400Bad Request

Modified at 2026-06-02 07:37:04

Place Order (委托下单)

Withdraw Order (撤销订单)