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 API document .
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 API document .
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 API document .
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 API document .
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 API document .
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:
| Scenario |
margin_mode |
dual_side |
leverage |
| Set isolated long leverage |
isolated |
dual_long |
"10" |
| Set isolated short leverage |
isolated |
dual_short |
"10" |
| Set cross leverage |
cross |
—— |
"10" |
For more details, please refer to the API document .
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).
Gate Team
April 28, 2026
Gateway to Crypto
Trade over 4,600 cryptocurrencies safely, quickly, and easily on Gate
Take Action Now
Sign up and claim up to $10,000 in welcome rewards
Invite friends and earn a 40% commission
Stay Connected
Visit Gate's official website
Download the Gate App | Desktop
Follow us on X (Twitter) to get more bonuses
Join our Telegram community to discuss trending topics
Engage with our global community for the latest insights
Transparency & Security
Check our 100% Proof of Reserves
