跳到主要内容

修改订单 (TRADE)

接口描述

修改订单功能,当前只支持限价(LIMIT)订单修改,修改后会在撮合队列里重新排序

HTTP请求

PUT /dapi/v1/order

请求权重

1

请求参数

名称类型是否必需描述
orderIdLONGNO系统订单号
origClientOrderIdSTRINGNO用户自定义的订单号
symbolSTRINGYES交易对
sideENUMYES买卖方向 SELL, BUY
quantityDECIMALNO下单数量,使用closePosition不支持此参数。
priceDECIMALNO委托价格
priceMatchENUMNOOPPONENT/ OPPONENT_5/ OPPONENT_10/ OPPONENT_20/QUEUE/ QUEUE_5/ QUEUE_10/ QUEUE_20;不能与price同时传
recvWindowLONGNO
timestampLONGYES
  • orderIdorigClientOrderId 必须至少发送一个,同时发送则以 order id为准
  • quantityprice 必须至少发送一个
  • 当新订单的quantityprice不满足PRICE_FILTER / PERCENT_FILTER / LOT_SIZE限制,修改会被拒绝,原订单依旧被保留
  • 订单会在下列情况下被取消:
    • 原订单被部分执行且新订单quantity <= executedQty
    • 原订单是GTX,新订单的价格会导致订单立刻执行
  • 同一订单修改次数最多10000次
  • 改单会将selfTradePreventionMode重置为NONE

响应示例

{
"orderId": 20072994037,
"symbol": "BTCUSD_PERP",
"pair": "BTCUSD",
"status": "NEW",
"clientOrderId": "LJ9R4QZDihCaS8UAOOLpgW",
"price": "30005",
"avgPrice": "0.0",
"origQty": "1",
"executedQty": "0",
"cumQty": "0",
"cumBase": "0",
"timeInForce": "GTC",
"type": "LIMIT",
"reduceOnly": false,
"closePosition": false,
"side": "BUY",
"positionSide": "LONG",
"stopPrice": "0",
"workingType": "CONTRACT_PRICE",
"priceProtect": false,
"origType": "LIMIT",
"priceMatch": "NONE",
"selfTradePreventionMode": "NONE",
"updateTime": 1629182711600
}