Amend Algo Order
Amend Algo Order
Modify an existing strategy/algo order. The modification type is determined by ordType. Consolidates the modify-position-sltp, amend-trigger-order, and trace order update endpoints.
Request URL
POST /deepcoin/v2/trade/amend-algos
Common Request Parameters
| Field Name | Required | Type | Description |
|---|---|---|---|
| instId | true | string | Product ID |
| algoId | true | string | Algo order ID |
| ordType | true | string | Algo order type: conditional / tp_sl / move_order_stop |
| conditional | false | object | Required when ordType=conditional. See conditional parameters below |
| tpSl | false | object | Required when ordType=tp_sl. See TP/SL parameters below |
| moveOrderStop | false | object | Required when ordType=move_order_stop. See move order stop parameters below |
ordType=conditional (Modify Conditional Order)
conditional modification parameters:
| Field Name | Required | Type | Description |
|---|---|---|---|
| newTriggerPx | false | string | New trigger price |
| newTriggerPxType | false | string | New trigger price type: last / index / mark |
| newOrderPx | false | string | New order price after trigger |
| newSz | false | string | New order size |
At least one modification field is required.
Request example:
{
"instId": "ETH-USDT-SWAP",
"algoId": "1000595855275418",
"ordType": "conditional",
"conditional": {
"newTriggerPx": "1850"
}
}
ordType=tp_sl (Modify Position TP/SL)
tpSl modification parameters:
| Field Name | Required | Type | Description |
|---|---|---|---|
| posSide | true | string | Position side (required for swaps): long / short |
| mrgPosition | true | string | Position mode (required for swaps): merge / split |
| tdMode | true | string | Margin mode (required for swaps): cross / isolated |
| posId | false | string | Position ID, required in split mode |
| newSz | false | string | New TP/SL size |
| newTpTriggerPx | false | float64 | New take-profit trigger price |
| newTpTriggerPxType | false | string | New take-profit trigger price type |
| newTpOrdPx | false | float64 | New take-profit order price |
| newSlTriggerPx | false | float64 | New stop-loss trigger price |
| newSlTriggerPxType | false | string | New stop-loss trigger price type |
| newSlOrdPx | false | float64 | New stop-loss order price |
Request example:
{
"instId": "ETH-USDT-SWAP",
"algoId": "1000595855275419",
"ordType": "tp_sl",
"tpSl": {
"tdMode": "cross",
"posSide": "long",
"mrgPosition": "merge",
"newTpTriggerPx": 2300,
"newSlTriggerPx": 1650
}
}
ordType=move_order_stop (Modify Trailing Stop)
moveOrderStop modification parameters:
| Field Name | Required | Type | Description |
|---|---|---|---|
| newTriggerPx | false | string | New activation price. -1 to activate immediately, 0 to cancel |
| newRetracePoint | false | string | New retracement spread |
Request example:
{
"instId": "ETH-USDT-SWAP",
"algoId": "1000595855280001",
"ordType": "move_order_stop",
"moveOrderStop": {
"newRetracePoint": "80"
}
}
Response Parameters
| Field Name | Type | Description |
|---|---|---|
| algoId | string | Algo order ID (returns empty for move_order_stop) |
| sCode | string | Result code, 0 means success |
| sMsg | string | Result message |
Response Example
{
"algoId": "1000595855275419",
"sCode": "0",
"sMsg": ""
}