Dear Poloniex Users,
To provide better services, Poloniex will be launching the Hedge Mode for futures trading, coexisting with isolated margin and cross margin modes, on November 7, 2024. Simply update your app to the latest version and you will enjoy the feature to hold both long and short positions under the cross margin mode or isolated margin mode for better risk management. Accordingly, we will adjust some API interfaces for futures trading.
Changes on API interfaces:
New interfaces:
Switch Position Modes: POST /v3/position/mode
View Position Mode: GET /v3/position/mode
Get Leverage List: Get /v3/position/leverages
Interfaces to be adjusted:
Place Order: POST /v3/trade/order
Place Multiple Orders: POST /v3/trade/orders
Close All at Market Price: POST /v3/trade/position
The above three interfaces will add request parameters: mgnMode and posSide.
Get Current Orders: GET /v3/trade/order/opens
Get Execution Details: GET /v3/trade/order/trades
Get Order History: GET /v3/trade/order/history
The above three interfaces will add a return parameter: posSide.
Get Position History: GET /v3/trade/position/history
It will add a request parameter: posSide.
Adjust Margin for Isolated Margin Trading Positions: POST /v3/trade/position/margin
It will add a request and return parameter: posSide.
Set Leverage: POST /v3/position/leverage
It will add request and response parameters: mgnMode and posSide.
Interfaces to be removed:
Switch Cross and Isolated Margin Modes: POST /v3/position/switchISOLATED
Get Margin Mode: GET /v3/position/marginType
Get Leverage: GET /v3/position/leverage
The above three interfaces remain accessible even after the retirement.
If you do not use the new feature of the Hedge Mode coexisting with cross margin and isolated margin modes, you can directly access the original API V3 interfaces. If you need to use the new feature, please pay attention to the above changes when using API.
For detailed information, please read our API documentation: https://api-docs.poloniex.com/v3/futures/
If you have any questions, please contact us at api-support@poloniex.com.
Poloniex Team
October 31, 2024