修改UM订单(TRADE)
接口描述
修改UM订单功能,当前只支持限价(LIMIT)订单修改,修改后会在撮合队列里重新排序
HTTP请求
PUT /papi/v1/um/order
请求权重(Order)
1
请求参数
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
orderId | LONG | NO | 系统订单号 |
origClientOrderId | STRING | NO | 用户自定义的订单号 |
symbol | STRING | YES | 交易对 |
side | ENUM | YES | 买卖方向 SELL , BUY ; side 需要和原订单相同 |
quantity | DECIMAL | YES | 下单数量 |
price | DECIMAL | YES | 委托价格 |
priceMatch | ENUM | NO | OPPONENT / OPPONENT_5 / OPPONENT_10 / OPPONENT_20 /QUEUE / QUEUE_5 / QUEUE_10 / QUEUE_20 ;不能与price同时传 |
recvWindow | LONG | NO | |
timestamp | LONG | YES |
- 原订单被部分执行且新订单quantity <= executedQty 原订单是GTX,新订单的价格会导致订单立刻执行 同一订单修改次数最多10000次 改单会保留该单原有的selfTradePreventionMode
- orderId 与 origClientOrderId 必须至少发送一个,同时发送则以 order id为准
- quantity 与 price 均必须发送
- 当新订单的 quantity 或 price 不满足PRICE_FILTER / PERCENT_FILTER / LOT_SIZE限制,修改会被拒绝,原订单依旧被保留
- 订单会在下列情况下被取消:
- 原订单被部分执行且新订单 quantity <= executedQty
- 原订单是GTX,新订单的价格会导致订单立刻执行
- 同一订单修改次数最多10000次
- 改单会保留该单原有的selfTradePreventionMode
响应示例
{
"orderId": 20072994037,
"symbol": "BTCUSDT",
"status": "NEW",
"clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW",
"price": "30005",
"avgPrice": "0.0",
"origQty": "1",
"executedQty": "0",
"cumQty": "0",
"cumQuote": "0",
"timeInForce": "GTC",
"type": "LIMIT",
"reduceOnly": false,
"side": "BUY",
"positionSide": "LONG",
"origType": "LIMIT",
"selfTradePreventionMode": "NONE",
"goodTillDate": 0
"updateTime": 1629182711600,
"priceMatch": "NONE"
}