Modify Order

Modify an existing unfilled futures order.

HTTP Request

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

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)
newClientOid	string	Yes	New client order ID for the modified order
orderId	string	No	Order ID (provide orderId or clientOid)
clientOid	string	No	Client order ID (provide orderId or clientOid)
newSize	string	No	New order size
newPrice	string	No	New order price
newPresetTakeProfitPrice	string	No	New take profit trigger price
newPresetStopLossPrice	string	No	New stop loss trigger price

Request Example

curl -X POST "https://open-api.bydoxe.com/api/v1/future/order/modify-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 '{
    "symbol": "BTCUSDT",
    "orderId": "fu-123456789",
    "newClientOid": "my-modified-order-001",
    "newSize": "0.6",
    "newPrice": "39500.00",
    "newPresetTakeProfitPrice": "42500.00",
    "newPresetStopLossPrice": "37500.00"
  }'

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object	Modified order response data
> orderId	string	New order ID after modification
> clientOid	string	New client order ID

Response Example

Success Response

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

Error Codes

Code	Message
40001	symbol does not exist
40001	Order ID or client order ID is required
40001	New client order ID is required
40001	New size, price, preset take profit price, or preset stop loss price is required
40001	Order not found
40001	Invalid new Order price
40001	New Size is too large
40001	New Size is too small
40001	New Size 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	Insufficient balance
40018	Order price decimal precision is too high