Modify Plan Order

Modify an existing trigger order (plan order) with new parameters.

HTTP Request

POST /api/v1/future/order/modify-plan-order

Request Parameters

Parameter	Type	Required	Description
orderId	string	No	Order ID (either orderId or clientOid required)
clientOid	string	No	Client order ID (either orderId or clientOid required)
newPrice	string	No	New order price
newSize	string	No	New order size
newTriggerPrice	string	No	New trigger price
newTriggerPriceType	string	No	New trigger price type: "LAST" or "MARK"
newPresetTakeProfitPrice	string	No	New take profit trigger price
newPresetTakeProfitExecutePrice	string	No	New take profit execution price
newPresetTakeProfitPriceType	string	No	New take profit price type: "LIMIT" or "MARKET"
newPresetStopLossPrice	string	No	New stop loss trigger price
newPresetStopLossExecutePrice	string	No	New stop loss execution price
newPresetStopLossPriceType	string	No	New stop loss price type: "LIMIT" or "MARKET"

Request Example

curl -X POST "https://open-api.bydoxe.com/api/v1/future/order/modify-plan-order" \
  -H "ACCESS-KEY: your-api-key" \
  -H "ACCESS-SIGN: your-signature" \
  -H "ACCESS-PASSPHRASE: your-passphrase" \
  -H "ACCESS-TIMESTAMP: 1659076670000" \
  -H "Content-Type: application/json" \
  -d '{
    "orderId": "fu-plan-123456789",
    "clientOid": "my-plan-order-001",
    "newPrice": "38800.00",
    "newSize": "0.6",
    "newTriggerPrice": "39100.00",
    "newTriggerPriceType": "LAST",
    "newPresetTakeProfitPrice": "42500.00",
    "newPresetTakeProfitExecutePrice": "42500.00",
    "newPresetTakeProfitPriceType": "LIMIT",
    "newPresetStopLossPrice": "36500.00",
    "newPresetStopLossExecutePrice": "36500.00",
    "newPresetStopLossPriceType": "LIMIT"
  }'

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object	Order response data
> orderId	string	Modified order ID
> clientOid	string	Client order ID

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1763459280000,
  "data": {
    "orderId": "fu-plan-123456790",
    "clientOid": "my-plan-order-001"
  }
}

Error Codes

Code	Message
40001	New size, price, preset take profit price, or preset stop loss price is required
40001	Invalid new Order price
40001	Order price decimal precision is too high
40001	New Size is too large
40001	New Size is too small
40001	New Size decimal precision is too high
40001	Invalid new Trigger price
40001	Trigger price decimal precision is too high
40001	New Take Profit price decimal precision is too high
40001	New Stop Loss price decimal precision is too high
40001	New Take Profit execute price decimal precision is too high
40001	New Stop Loss execute price decimal precision is too high
40001	Insufficient balance
40026	Order ID or client order ID is required
40028	Order not found