Announcements Gate Perpetual Futures API Update: Added Support for Hedge Split Mode

Gate Perpetual Futures API Update: Added Support for Hedge Split Mode

2026-04-28 12:09:20 UTC 189 Read

[//]:content-type-MARKDOWN-DONOT-DELETE
To further enhance the strategic flexibility of perpetual futures trading, Gate has previously launched the **Hedge Split Mode** on the perpetual futures platform. To meet the automated trading needs of API users, we will upgrade the relevant perpetual futures API endpoints on **April 30, 2026** **UTC** to officially support **Hedge Split Mode**

### 1. Feature Overview
**Hedge Split Mode** allows users to simultaneously hold positions across multiple directions and margin modes within the same perpetual contract market, including: Cross Long, Cross Short, Isolated Long, and Isolated Short.
Under Isolated mode, long and short positions can be configured with independent leverage settings, which are also independent from the leverage configuration of Cross positions.
For more details, please refer to the product announcement: https://www.gate.com/announcements/article/49810

### 2. API Change Details
#### 2.1 Switch Position Mode
Endpoint: POST /api/v4/futures/{settle}/set_position_mode

* New request parameter position_mode , with the following values:
single: Single-direction (One-way) mode
dual: Dual-direction (Hedge) mode
dual_plus: Hedge Split position mode
* Response includes new field position_mode
* Upon successfully switching to **Hedge Split Mode** , the response returns position_mode = dual_plus
* For more details, please refer to the <a href="https://www.gate.com/docs/developers/apiv4/en/futures/#set-position-holding-mode-replacing-the-dual-mode-interface" target="_blank">API document</a> .

#### 2.2 Place Order
Endpoints:

* POST /api/v4/futures/{settle}/orders
* New request field pos_margin_mode, with values:
cross: Cross margin
isolated: Isolated margin
* Response structure remains unchanged
* For more details, please refer to the <a href="https://www.gate.com/docs/developers/apiv4/en/futures/#place-futures-order" target="_blank">API document</a> .

#### 2.3 Query Account
Endpoint: GET /api/v4/futures/{settle}/accounts
* Response includes new field position_mode , with values:
single: One-way
dual: Hedge
dual_plus: Split
* For more details, please refer to the <a href="https://www.gate.com/docs/developers/apiv4/en/futures/#get-futures-account" target="_blank">API document</a> .

#### 2.4 Query Position
Endpoint:
GET /api/v4/futures/{settle}/positions/{contract}

* New field pos_margin_mode : indicates the margin mode of the position
cross: Cross
isolated: Isolated
* New field lever: indicates the current leverage of the position, which will gradually replace the existing leverage and cross_leverage_limit fields
* For more details, please refer to the <a href="https://www.gate.com/docs/developers/apiv4/en/futures/#get-user-position-list" target="_blank">API document</a> .

#### 2.5 Query Orders
Endpoint: GET /api/v4/futures/{settle}/orders

* Response includes new field pos_margin_mode , with values:
cross: Cross
isolated: Isolated
* For more details, please refer to the <a href="https://www.gate.com/docs/developers/apiv4/en/futures/#query-futures-order-list" target="_blank">API document</a> .

#### 2.6 Set Position Leverage
Endpoint:
POST /api/v4/futures/{settle}/positions/{contract}/set_leverage
Parameters:
* margin_mode (required): margin mode, either cross or isolated
* dual_side (optional): used under Isolated mode to specify directional leverage, with values dual_long (long side) or dual_short (short side)
* leverage (required): leverage value, string type

Examples:

For more details, please refer to the <a href="https://www.gate.com/docs/developers/apiv4/en/futures/#update-leverage-for-specified-mode" target="_blank">API document</a> .

### 3. Notes

* **Lead Trader Restriction:** Users currently in Lead Trader mode are not supported to switch to Hedge Split Mode. Please end your lead trading session before switching modes.
* **Risk Acknowledgment:** Before switching to Hedge Split Mode, please ensure you have fully understood the associated risks and margin rules.
* **Leverage Field Migration:** The original leverage-related fields leverage and cross_leverage_limit will remain available. When using Hedge Split Mode, it is recommended to use the new field lever to obtain the actual position leverage.
* **Margin Mode Determination:** Please use the pos_margin_mode field to determine whether a position/order is cross margin or isolated margin ( cross / isolated ). Do not rely on the original logic of checking whether leverage is 0 (where leverage ≠ 0 indicates isolated margin, and leverage = 0 indicates cross margin).

Change & Chart Start-End Time

Rise/Fall Color

Pay With

Gate Perpetual Futures API Update: Added Support for Hedge Split Mode

Gate Perpetual Futures API Update: Added Support for Hedge Split Mode

Select language and region

Select your region

Fiat Currencies