修改订单
修改订单
修改未完成订单的价格、数量及附带止盈止损。
请求地址
POST /deepcoin/v2/trade/amend-order
请求参数
| 字段名 | 是否必填 | 类型 | 字段描述 |
|---|---|---|---|
| instId | 是 | string | 产品 ID |
| ordId | 否 | string | 订单 ID。ordId 和 clOrdId 至少传一个,若传两个以 ordId 为主 |
| clOrdId | 否 | string | 客户自定义订单 ID,长度 1-20,字母和数字组合 |
| order | 否 | object | 普通委托价格、数量修改参数,与 attachedTpSl 至少传一个 |
| attachedTpSl | 否 | object | 限价开仓单附带止盈止损修改参数,与 order 至少传一个 |
order 参数:
| 字段名 | 是否必填 | 类型 | 字段描述 |
|---|---|---|---|
| newPx | 否 | float64 | 新价格,与 newSz 至少传一个 |
| newSz | 否 | float64 | 新数量,与 newPx 至少 传一个 |
attachedTpSl 参数:
| 字段名 | 是否必填 | 类型 | 字段描述 |
|---|---|---|---|
| newTpTriggerPx | 否 | float64 | 新止盈触发价 |
| newSlTriggerPx | 否 | float64 | 新止损触发价 |
| cancelTp | 否 | bool | 取消当前限价开仓单附带止盈,为 true 时不得同时传 newTpTriggerPx |
| cancelSl | 否 | bool | 取消当前限价开仓单附带止损,为 true 时不得同时传 newSlTriggerPx |
请求示例
// 只改普通委托价格
{
"instId": "ETH-USDT-SWAP",
"ordId": "1000597858003301",
"order": {
"newPx": 1800
}
}
// 只改普通委托数量
{
"instId": "ETH-USDT-SWAP",
"ordId": "1000597858003301",
"order": {
"newSz": 2
}
}
// 同时修改价格和数量
{
"instId": "ETH-USDT-SWAP",
"ordId": "1000597858003301",
"order": {
"newPx": 1850,
"newSz": 3
}
}
// 修改限价开仓单附带止盈止损
{
"instId": "ETH-USDT-SWAP",
"ordId": "1000597858003301",
"attachedTpSl": {
"newTpTriggerPx": 2200,
"newSlTriggerPx": 1700
}
}
// 取消限价开仓单附带止盈
{
"instId": "ETH-USDT-SWAP",
"ordId": "1000597858003301",
"attachedTpSl": {
"cancelTp": true
}
}
响应参数
| 字段名 | 类型 | 字段描述 |
|---|---|---|
| ordId | string | 订单 ID |
| clOrdId | string | 客户自定义订单 ID |
| sCode | string | 状态码,"0" 表示成功 |
| sMsg | string | 状态消息 |
响应示例
{
"ordId": "1000597858003301",
"clOrdId": "",
"sCode": "0",
"sMsg": "Success"
}