Timestamp statements

API Futures API
,
1

Hello!
Colleagues, in order to clarify all timestamp statements, we need your help for checking and correcting (if needed) of our API parameters understanding.

As for timestamps of our requests that are given by Binance, there are three resources:

  1. REST API

1.1. New Order
1.1.1. DAPI https://binance-docs.github.io/apidocs/delivery/en/#new-order-trade
1.1.2. FAPI https://binance-docs.github.io/apidocs/futures/en/#new-order-trade
updateTime - Time when an order has really been placed in the orderbook.
1.1.3. SAPI https://binance-docs.github.io/apidocs/spot/en/#new-order-trade
transactTime - Time when an order has really been placed in the orderbook.

1.2. Order’s Status
1.2.1. DAPI https://binance-docs.github.io/apidocs/delivery/en/#query-order-user_data
1.2.2. FAPI https://binance-docs.github.io/apidocs/futures/en/#query-order-user_data
1.2.3. SAPI https://binance-docs.github.io/apidocs/spot/en/#query-order-user_data
There are two fields related to timestamps:
a. updateTime (// update time - in the description) - last update of the order.
b. time (// order time - in the description) - Time when the order was placed in the orderbook.

  1. WEB SOCKETS

2.1. Event Order Update

2.1.1. DAPI https://binance-docs.github.io/apidocs/delivery/en/#event-order-update
2.1.2. FAPI https://binance-docs.github.io/apidocs/futures/en/#event-order-update
a. “E” (described as “Event Time”) - equals to time when the web socket event has been sent.
b. “T” (described as “Transaction Time”) - equals to time when the order has been changed.
c. “T” in “о”- object (described as “Order Trade Time”) - equals to last trade time of this order.

2.1.3.SAPI https://binance-docs.github.io/apidocs/spot/en/#payload-order-update
a. “E” (described as “Event Time”) - equals to time when the web socket event has been sent.
b. “T” (described as “Transaction Time”) - equals to time when the order has been changed.
c. “O” (described as “Order creation time”) - equals to time when the order has been placed in the orderbook.

I would appreciate any clarification.

2

The updateTime and transactTime is the timestamp for when the order was matched or placed in the order book.

1.2. Order’s Status
1.2.1. DAPI Binance API Documentation
1.2.2. FAPI Binance API Documentation
1.2.3. SAPI Binance API Documentation
There are two fields related to timestamps:
a. updateTime (// update time - in the description) - last update of the order.
b. time (// order time - in the description) - Time when the order was placed in the orderbook.

time is the timestamp of when the order was placed in the order book, while updateTime is the timestamp of the last order state change.

  1. WEB SOCKETS
    2.1. Event Order Update
    2.1.1. DAPI https://binance-docs.github.io/apidocs/delivery/en/#event-order-update
    2.1.2. FAPI https://binance-docs.github.io/apidocs/futures/en/#event-order-update
    a. “E” (described as “Event Time”) - equals to time when the web socket event has been sent.
    b. “T” (described as “Transaction Time”) - equals to time when the order has been changed.
    c. “T” in “о”- object (described as “Order Trade Time”) - equals to last trade time of this order.
    2.1.3.SAPI https://binance-docs.github.io/apidocs/spot/en/#payload-order-update
    a. “E” (described as “Event Time”) - equals to time when the web socket event has been sent.
    b. “T” (described as “Transaction Time”) - equals to time when the order has been changed.
    c. “O” (described as “Order creation time”) - equals to time when the order has been placed in the orderbook.

These are all correct.

1 Like