Skip to main content
Updates the price and/or amount of an existing active order via WebSocket API. It is not possible to change a canceled or fully executed order.

​
Request

​
id
string
required
Unique request identifier for correlation
​
method
string
required
WebSocket API method. Must be order.update
​
params
object
required
Request parameters containing authentication and update details
At least one of price or amount must be provided. The order must be active (open or partially executed) to be updated. Canceled or fully executed orders cannot be modified.

​
Response

​
id
string
Request identifier for correlation
​
status
integer
HTTP status code (200 for success)
​
result
null
Always null for successful update responses. The update is confirmed by the 200 status code.

​
Error Response

​
id
string
Request identifier for correlation
​
status
integer
HTTP error status code
​
result
null
Always null for error responses
​
error
object
Error details object

​
Examples

{
  "id": "req-005",
  "method": "order.update",
  "params": {
    "api_token": "your-api-token",
    "timestamp": 1634567890000,
    "signature": "calculated-signature",
    "order_id": "7155ED34-9EC4-4733-8B32-1E4319CB662F",
    "price": 105000,
    "amount": 0.002
  }
}

​
Success Response Example

{
  "id": "req-005",
  "status": 200,
  "result": null
}

​
Error Response Examples

​
Order Not Found

{
  "id": "req-005",
  "status": 404,
  "result": null,
  "error": {
    "error_code": 40401,
    "message": "Order not found."
  }
}

​
Order Not Active

{
  "id": "req-005",
  "status": 400,
  "result": null,
  "error": {
    "error_code": 40408,
    "message": "Cannot update a canceled or fully executed order."
  }
}

​
Missing Price and Amount

{
  "id": "req-005",
  "status": 400,
  "result": null,
  "error": {
    "error_code": 40010,
    "message": "At least one of price or amount must be provided."
  }
}

​
Invalid Signature

{
  "id": "req-005",
  "status": 400,
  "result": null,
  "error": {
    "error_code": 40011,
    "message": "Invalid signature or timestamp expired."
  }
}

​
Update Scenarios

​
Scenario 1: Adjust Price

If you want to change the order’s price while keeping the amount the same:
  • Provide only the price parameter
  • The order amount remains unchanged

​
Scenario 2: Adjust Amount

If you want to change the order’s amount while keeping the price the same:
  • Provide only the amount parameter
  • The order price remains unchanged

​
Scenario 3: Adjust Both Price and Amount

If you want to change both the price and amount:
  • Provide both price and amount parameters
  • Both values will be updated

​
Important Notes

  • Order Status: Only active orders (status open or executed_partially) can be updated
  • Canceled Orders: Cannot be updated
  • Fully Executed Orders: Cannot be updated
  • Partial Execution: If an order has been partially executed, you can still update the remaining amount
  • Update Confirmation: A successful response returns status 200 with result: null. This confirms the update was applied
  • Idempotency: If you send the same update request twice with different request IDs, both updates will be applied
  • Request Correlation: Always use a unique id in each request for proper correlation with responses

​
Update Restrictions

​
Updatable Order Types

Most order types support updates:
  • Limit orders: ✓ Can update price and amount
  • Market orders: May have restrictions depending on execution stage
  • Stop Limit orders: ✓ Can update price and amount
  • Trailing orders: ✓ Can update price and distance
  • Ceiling orders: ✓ Can update value
  • Iceberg orders: ✓ Can update price and step amount

​
Cannot Update

  • Already canceled orders
  • Fully executed orders (status: executed_completely)
  • Orders after partial execution (in some cases)

​
Common Error Codes

Error CodeMessageDescription
40401Order not foundThe order ID does not exist
40408Cannot update a canceled or fully executed orderThe order is not in an updatable state
40010At least one of price or amount must be providedNeither price nor amount was provided
40011Invalid signature or timestamp expiredAuthentication failed
40012Invalid price or amountThe provided values are invalid or out of acceptable range