Skip to main content

修改CM订单(TRADE)

接口描述#

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

HTTP请求#

PUT /papi/v1/cm/order

请求权重(Order)#

1

请求参数#

名称类型是否必需描述
orderIdLONGNO系统订单号
origClientOrderIdSTRINGNO用户自定义的订单号
symbolSTRINGYES交易对
sideENUMYES买卖方向 SELL, BUY; side需要和原订单相同
quantityDECIMALYES下单数量
priceDECIMALYES委托价格
recvWindowLONGNO
timestampLONGYES
  • orderIdorigClientOrderId 必须至少发送一个,同时发送则以 order id为准
  • quantityprice 必须全部发送
  • 当新订单的quantityprice不满足PRICE_FILTER / PERCENT_FILTER / LOT_SIZE限制,修改会被拒绝,原订单依旧被保留
  • 订单会在下列情况下被取消:
    • 原订单被部分执行且新订单quantity <= executedQty
    • 原订单是GTX,新订单的价格会导致订单立刻执行
  • 同一订单修改次数最多10000次

响应示例#

{    "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,    "side": "BUY",    "positionSide": "LONG",    "origType": "LIMIT",    "updateTime": 1629182711600}