修改CM订单(TRADE)
接口描述
修改CM订单功能,当前只支持限价(LIMIT)订单修改,修改后会在撮合队列里重新排序
HTTP请求
PUT /papi/v1/cm/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 | 
orderId与origClientOrderId必须至少发送一个,同时发送则以 order id为准quantity与price必须全部发送- 当新订单的
 quantity或price不满足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
}