修改订单
修改现有订单的价格、数量或触发价格。amendType 字段用于选择要更改的字段及所需的输入项。
请求参数
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| orderId | String | 否 | 要修改订单 的服务器分配订单 ID。若未提供 clOrderId 则必填。 |
| clOrderId | String | 否 | 要修改订单的客户端分配订单 ID。若未提供 orderId 则必填。 |
| symbol | String | 是 | 要修改订单的交易对。 |
| amendType | String | 是 | 要修改的字段：PRICE、SIZE、TRIGGER_PRICE 或 ALL。 |
| orderSize | Double | 否 | 新的订单数量（合约张数）。当 amendType 为 SIZE，或与 orderPrice 一同使用的 ALL 时必填。 |
| orderPrice | Double | 否 | 新的限价。当 amendType 为 PRICE（除非 slide 为 true），或与 orderSize 一同使用的 ALL 时必填。 |
| triggerPrice | Double | 否 | 新的触发价格。当 amendType 为 TRIGGER_PRICE 时必填。 |
| slide | Boolean | 否 | 若为 true 且 amendType 为 PRICE，则价格会滑动到当前最优价格，而非取自 orderPrice。 |
| totalAmountMode | Boolean | 否 | 若为 true，orderSize 将被视为期望的原始订单总量，而非增量变化。 |
响应内容
| 名称 | 类型 | 描述 |
|---|---|---|
| orderId | String | 被修改订单的服务器分配订单 ID。 |
| clOrderId | String | 从请求中回传的客户端分配订单 ID。 |
| symbol | String | 被修改订单的交易对。 |
| orderSide | String | 订单方向：BUY 或 SELL。 |
| type | Integer | 订单类型代码。 |
| orderPrice | Double | 修改后的限价。 |
| orderSize | Double | 修改后的订单数量（合约张数）。 |
| triggerPrice | Double | 修改后的触发价格（如适用）。 |
| status | Integer | 修改后的订单状态代码。 |
| timestamp | Long | 修改的服务器时间戳，单位为自 epoch 起的毫秒数。 |
example
PUT
https://api.btse.com/futures/api/v3/trade/ordersRequest (default)
{
"symbol": "BTC-PERP",
"orderId": "0251ea47-88b5-48c0-aeb3-b38774fd1f90",
"amendType": "PRICE",
"orderPrice": 56439.4
}
Response (default)
[
{
"orderId": "0251ea47-88b5-48c0-aeb3-b38774fd1f90",
"clOrderId": "",
"symbol": "BTC-PERP",
"orderSide": "BUY",
"type": 76,
"orderPrice": 56439.4,
"orderSize": 1,
"triggerPrice": 0,
"status": 123,
"timestamp": 1784882344404
}
]