All Devices
Exit all terminal accounts APP/PC/WAP
This Device
Exit the current web account
Announcements
Gate.io APIv4 Update: Two-Side Position Mode & Liquidation Orders Interface
Gate.io APIv4 Update: Two-Side Position Mode & Liquidation Orders Interface
2020-12-09 09:52:31 UTC
46654 Read
Gate.io has added a “ two-side position” mode and liquidation order open-end interface in the APIv4. These two new features are also available on our SDK. You are welcome to try them out now ( https://www.gate.io/en/api2).
What’s new in this APIV4 update
1.Perpetual contracts (USDT margin) have added support for two-side positions. For reference, you can go to ” /futures/{settle}/dual_comp/positions”sections.
2.Added Perpetual contract account return “in_dual_mode and position return “ dual_mode”
3. Added “ /futures/{settle}/liq_orders ” to allow querying liquidation records on the market.
For more about this update, please read: https://www.gate.io/docs/apiv4/en/index.html#changelog
About the two-side position mode
The two-side positions, as the name suggests, allows users to have both long and short positions for the same perpetual contract. Unlike a one-side position mode, where you can go long or short and the opposite orders will reduce your existing position automatically, users have four selections in a two-side positions mode: open long position, open short position, close long position, and close short position.
How to open two sides positions under the same perpetual contract?
1.Toggle Position Mode
The perpetual contract supports the one-side position mode by default. You may toggle the mode to “Two-Side Position’ by clicking the setup icon on the upper left corner and selecting the two-side positions mode.
The new mode will apply to all perpetual contracts with the same margin currency. Please note, you can only toggle the position mode when there are no open positions or orders under all perpetual contracts of the same margin currency.
2. Choose Margin Type
2.1 Isolated Margin
Under the isolated margin type, the margin is isolated for the two positions; risks of one position do not affect the other. You will be able to observe separate margin, liquidation prices for each position. But the leverage ratio and risk limit under the perpetual contract will apply to both positions.
2.2 Cross Margin
When using cross margin, the two positions will share the same margin. As the two positions hedge each other, in the event of a liquidation, only the extra portion that can’t be offset by the opposition position would be liquidated; if both positions are of the same size, there would be no liquidation risk at all. Both two positions’ unrealised profit and loss will offset, though displaying as“unrealized”PNL for each position. It is recorded as realized PNL in history records.
3. Toggle Between Isolated and Cross Margin
You can toggle between isolated and cross margin only when there are no open positions or orders under the perpetual contract.
4. Place Order
In a two-side position mode, a position can only be a long position or a short position. Therefore, there is no more “reduce position” selection. Instead, you have Open Long Position, Open Short Position, Close Long Position, Close Short Position selections.
Please note, when displaying the historical orders, they still display the old way.
Gate.io is an established exchange that holds integrity, transparency, and fairness to a very high standard. We charge zero listing fees and only choose quality and promising projects. Our exchange consists only of 100% real trading volume. Thanks to everyone who has joined us in our journey. We always intend to improve and innovate to reward our users for their continuous support.
Gate.io Team
December 9, 2020
Get 30% of all referees' trading fees in the affiliate program at https://www.gate.io/referral
Click to Sign up ：https://www.gate.io/m#/register
Download it now at: https://www.gate.io/mobileapp
Follow us on social
Facebook: https://facebook.com/gateioglobal
Twitter: https://twitter.com/gate_io
Telegram：https://t.me/gateio
Instagram：https://www.instagram.com/gateioglobal
Medium：https://medium.com/@gateio
What’s new in this APIV4 update
1.Perpetual contracts (USDT margin) have added support for two-side positions. For reference, you can go to ” /futures/{settle}/dual_comp/positions”sections.
2.Added Perpetual contract account return “in_dual_mode and position return “ dual_mode”
3. Added “ /futures/{settle}/liq_orders ” to allow querying liquidation records on the market.
For more about this update, please read: https://www.gate.io/docs/apiv4/en/index.html#changelog
About the two-side position mode
The two-side positions, as the name suggests, allows users to have both long and short positions for the same perpetual contract. Unlike a one-side position mode, where you can go long or short and the opposite orders will reduce your existing position automatically, users have four selections in a two-side positions mode: open long position, open short position, close long position, and close short position.
How to open two sides positions under the same perpetual contract?
1.Toggle Position Mode
The perpetual contract supports the one-side position mode by default. You may toggle the mode to “Two-Side Position’ by clicking the setup icon on the upper left corner and selecting the two-side positions mode.
The new mode will apply to all perpetual contracts with the same margin currency. Please note, you can only toggle the position mode when there are no open positions or orders under all perpetual contracts of the same margin currency.
2. Choose Margin Type
2.1 Isolated Margin
Under the isolated margin type, the margin is isolated for the two positions; risks of one position do not affect the other. You will be able to observe separate margin, liquidation prices for each position. But the leverage ratio and risk limit under the perpetual contract will apply to both positions.
2.2 Cross Margin
When using cross margin, the two positions will share the same margin. As the two positions hedge each other, in the event of a liquidation, only the extra portion that can’t be offset by the opposition position would be liquidated; if both positions are of the same size, there would be no liquidation risk at all. Both two positions’ unrealised profit and loss will offset, though displaying as“unrealized”PNL for each position. It is recorded as realized PNL in history records.
3. Toggle Between Isolated and Cross Margin
You can toggle between isolated and cross margin only when there are no open positions or orders under the perpetual contract.
4. Place Order
In a two-side position mode, a position can only be a long position or a short position. Therefore, there is no more “reduce position” selection. Instead, you have Open Long Position, Open Short Position, Close Long Position, Close Short Position selections.
Please note, when displaying the historical orders, they still display the old way.
Gate.io is an established exchange that holds integrity, transparency, and fairness to a very high standard. We charge zero listing fees and only choose quality and promising projects. Our exchange consists only of 100% real trading volume. Thanks to everyone who has joined us in our journey. We always intend to improve and innovate to reward our users for their continuous support.
Gate.io Team
December 9, 2020
Get 30% of all referees' trading fees in the affiliate program at https://www.gate.io/referral
Click to Sign up ：https://www.gate.io/m#/register
Download it now at: https://www.gate.io/mobileapp
Follow us on social
Facebook: https://facebook.com/gateioglobal
Twitter: https://twitter.com/gate_io
Telegram：https://t.me/gateio
Instagram：https://www.instagram.com/gateioglobal
Medium：https://medium.com/@gateio
