Skip to main content

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 NameRequiredTypeDescription
instIdtruestringProduct ID
algoIdtruestringAlgo order ID
ordTypetruestringAlgo order type: conditional / tp_sl / move_order_stop
conditionalfalseobjectRequired when ordType=conditional. See conditional parameters below
tpSlfalseobjectRequired when ordType=tp_sl. See TP/SL parameters below
moveOrderStopfalseobjectRequired when ordType=move_order_stop. See move order stop parameters below

ordType=conditional (Modify Conditional Order)

conditional modification parameters:

Field NameRequiredTypeDescription
newTriggerPxfalsestringNew trigger price
newTriggerPxTypefalsestringNew trigger price type: last / index / mark
newOrderPxfalsestringNew order price after trigger
newSzfalsestringNew 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 NameRequiredTypeDescription
posSidetruestringPosition side (required for swaps): long / short
mrgPositiontruestringPosition mode (required for swaps): merge / split
tdModetruestringMargin mode (required for swaps): cross / isolated
posIdfalsestringPosition ID, required in split mode
newSzfalsestringNew TP/SL size
newTpTriggerPxfalsefloat64New take-profit trigger price
newTpTriggerPxTypefalsestringNew take-profit trigger price type
newTpOrdPxfalsefloat64New take-profit order price
newSlTriggerPxfalsefloat64New stop-loss trigger price
newSlTriggerPxTypefalsestringNew stop-loss trigger price type
newSlOrdPxfalsefloat64New 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 NameRequiredTypeDescription
newTriggerPxfalsestringNew activation price. -1 to activate immediately, 0 to cancel
newRetracePointfalsestringNew retracement spread

Request example:

{
"instId": "ETH-USDT-SWAP",
"algoId": "1000595855280001",
"ordType": "move_order_stop",
"moveOrderStop": {
"newRetracePoint": "80"
}
}

Response Parameters

Field NameTypeDescription
algoIdstringAlgo order ID (returns empty for move_order_stop)
sCodestringResult code, 0 means success
sMsgstringResult message

Response Example

{
"algoId": "1000595855275419",
"sCode": "0",
"sMsg": ""
}