questions regarding order properties "updateTime", "isWorking", "status"

API Spot/Margin API
1

The endpoint GET /api/v3/openOrders returns an order response containing the following two properties:

..
"updateTime": 1499827319559,
..
"isWorking": true,
..
  1. What is the updateTime? The time, when the order was last edited by the user?
  2. And what about isWorking? Is this not redundant to status? For example, if status: "NEW", then isWorking is also true. So what is the sense for distinguishing between isWorking and status?
2
  1. What is the updateTime ? The time, when the order was last edited by the user?

updateTime is the timestamp of the last state change of the order (ex. Partially Filled, Filled, Expired ect…)

  1. And what about isWorking? Is this not redundant to status? For example, if status: "NEW", then isWorking is also true. So what is the sense for distinguishing between isWorking and status?

IsWorking is a flag, commonly used when placing STOP orders, to indicate if the order is/was in-effect or not.

For instance, when a stop order is first placed, isWorking is set to False. When the stop price is hit, the isWorking flag is set to True. No matter the price variation while the stop order is working, the isWorking flag will not change value. Once the stop order is filled, the isWorking flag remains True.

Status, on the other hand, is used to provide a more detailed context to the state of the order as opposed to a 2-state variable [boolean].

3

Thanks. Would be nice to include the information about “updateTime” in the dedicated API documention.

4

This statement is already included in the change-log. However I understand documentation can be improved.

2018-07-18
Rest API Order lookups now return updateTime which represents the last time the order was updated

1 Like
5

Yes, it makes more sense to add this information to the dedicated table where those properties are described,.