Dear user:

Binance Futures will modify the order return logic for U-based contracts starting from 14:00 on March 22, 2023 (Eastern Eighth District time).

Front-end changes:

  • For FOK orders (full fill or cancel), if the order is not filled immediately, the order will be rejected immediately.

  • For Maker only orders (Post Only orders), if the order cannot be placed with a Maker order, the order will be rejected immediately.

  • The above rejected orders will not be saved in the order history.

API changes:

  • For timeInForce FOK orders (all filled or canceled), if the order is not filled immediately, the order will be rejected immediately, and an error code numbered 5021 will be returned in the interface.

  • For timeInForce GTX (Post Only order), if it cannot be placed with a Maker order, the order will be rejected immediately, and an error code numbered 5022 will be returned in the interface.

  • The above rejected orders will not be saved in the order history and therefore will not be found in GET/fapi/v1/order or GET/fapi/v1/allOrders. At the same time, order_trade_update information will not be received through websocket.

Affected nodes:

  • POST/fapi/v1/order（HMAC SHA256）

  • POST/fapi/v1/batchOrders（HMAC SHA256）

  • GET/fapi/v1/order（HMAC SHA256）

  • GET/fapi/v1/allOrders（HMAC SHA256）

Since this return information is different from the previous order return information, Binance recommends that users pay attention to the changes in order return logic. For more information and examples, please refer to the API doc change log updated on March 8, 2023 (East Eighth District time), and this FAQ.

Note: If the translation of this announcement is inconsistent with the original English text, the English version shall prevail.

Thank you for your support of Binance!

Binance Team

March 15, 2023

Click to download the iPhone or Android version of the APP now

Binance Community

  • Discord

  • Facebook

  • Twitter

  • Chinese Twitter

Note: This announcement was updated on March 21, 2023. The update time for contract orders is changed from 17:00 on March 21, 2023 (East Eighth District time) to 14:00 on March 22, 2023 (East Eighth District time). time). This advisory was updated on March 16, 2023 to clarify that order_trade_update information will not be received via websocket.

Binance has always attached great importance to compliance obligations, and has always strictly abided by the relevant requirements of local regulatory agencies, and please abide by the relevant laws and regulations of the country or region where you are located.
Binance reserves the right to modify, change or cancel this announcement at any time and for any reason at its sole discretion without prior notice.

Risk warning: Digital asset prices are subject to high market risk and price volatility. The value of your investment may fluctuate and you may lose the amount invested. You will be solely responsible for your investment decisions, and Binance is not responsible for any losses that may occur. In particular, options trading is subject to high market risks and price fluctuations, and past performance is not a reliable predictor of future performance. Before trading, you should make your own assessment of whether trading is suitable based on your own objectives and circumstances, including risks and potential benefits, and consult an independent financial advisor. This article should not be considered financial or investment advice. If you want to know how to trade responsibly, please refer to the Binance Responsible Trading Information Page. Please see Binance’s Terms of Use and Risk Warning for more details.