Fellow Binancians,
Binance Futures will change the below order response logic for USDⓈ-M Perpetual Contracts starting from 2023-03-22 06:00 (UTC).
UI Changes:
- For FOK (Fill or Kill Order), it will be rejected if the order cannot be filled immediately.
- For Post Only Order, it will be rejected if the order cannot be placed as a maker order.
- The above rejected orders will not be kept in order history.
API Changes:
- For orders with timeInForce FOK (Fill or Kill Order), it will be rejected with response error code - 5021 if the order cannot be filled immediately.
- For orders with timeInForce GTX (Post Only Order), it will be rejected with response error code - 5022 if the order cannot be placed as a maker order.
- The above rejected orders will not be kept in order history, and thus will not be found in GET /fapi/v1/order or GET /fapi/v1/allOrders. In addition, no order_trade_update messages will be sent via websocket.
Impacted Endpoints:
- POST /fapi/v1/order (HMAC SHA256)
- POST /fapi/v1/batchOrders (HMAC SHA256)
- GET /fapi/v1/order (HMAC SHA256)
- GET /fapi/v1/allOrders (HMAC SHA256)
As the response messages will be different from the previous messages, users are advised to take notice of the order response logic change. Please find more information and examples in the API Change Log on 2023-03-08 (UTC) and this FAQ.
Note: Where any discrepancy arises between the translated versions and the original English version, the English version shall prevail.
Note: Where any discrepancy arises between the translated versions and the original English version, the English version shall prevail.
Thanks for your support!
Binance Team
2023-03-15
Find us on
Note: This announcement was last updated on 2023-03-21 to highlight that the above changes will take effect on 2023-03-22 06:00 (UTC) instead of 2023-03-21 09:00 (UTC), and on 2023-03-16 to clarify that no order_trade_update messages will be sent via websocket.
Binance reserves the right in its sole discretion to amend or cancel the products referred to in this announcement at any time and for any reasons without prior notice.
Risk Warning: Digital asset prices can be volatile. The value of your investment may go down or up and you may not get back the amount invested. You are solely responsible for your investment decisions and Binance is not liable for any losses you may incur. Options trading, in particular, is subject to high market risk and price volatility. Past performance is not a reliable predictor of future performance. Before trading, you should make an independent assessment of the appropriateness of the transaction in light of your own objectives and circumstances, including the risks and potential benefits. Consult your own advisers, where appropriate. This information should not be construed as financial or investment advice. To learn more about how to protect yourself, visit our Responsible Trading page. For more information, see our Terms of Use and Risk Warning.