| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Update the position mode of your trading portfolio on a specific exchange (currently BINANCE, OKX, EDX). You can switch between one-way (NET) mode and hedge (BOTH) mode for all contracts on that venue.
Important: This setting only applies to derivatives positions and orders on the exchange. Spot orders and spot holdings are not affected by this operation.
Before changing the position mode, you must close all derivatives positions and cancel all open derivatives orders on that exchange. If there are any remaining derivatives positions or active derivatives orders, the request will fail according to the exchange's rules.
Rate Limit: 50 requests per 10 seconds.
Permission: Accessible by Main or Sub Trading Portfolio API keys with trade permission.
Request Parameters
| Field | Type | Mandatory | Description |
|---|---|---|---|
exchangeType | String | Y | Exchange where the position mode should be updated, e.g. BINANCE, OKX, EDX. |
positionMode | String | Y | Target position mode on this exchange: NET for one-way mode (single net position per symbol), BOTH for hedge mode (independent long/short positions). |
Response Fields
| Field | Type | Description |
|---|---|---|
code | Integer | Business status code, 200000 indicates success. |
message | String | Result message, "Success" on successful operation. |
data | Object | Empty object for this endpoint (no extra payload). |
Example Response
{
"code": 200000,
"message": "Success",
"data": {}
}