Change Position Mode

Change the position mode (one-way / hedge) for a specified trading pair.

API Information

• Method: PUT
• Path: /fapi/v1/configs/{symbol}/position-mode
• Authentication: Requires signature authentication (see Common Module · Signature Specification)

Request Parameters

Parameter	Location	Type	Required	Description
symbol	path	string	Yes	Trading pair

Body

Parameter	Type	Required	Description
position_mode	integer	Yes	Position mode: 1=one-way, 2=hedge

Request Example

PUT /fapi/v1/configs/BTC_USDT/position-mode

{
  "position_mode": 2
}

Response Fields

Returns the full configuration after modification.

Field	Type	Description
code	integer	Status code
message	string	Response message
data.symbol	string	Trading pair
data.position_mode	integer	Position mode: 1=one-way, 2=hedge
data.leverage / leverage_long / leverage_short	integer	Leverage configuration
data.margin_mode	integer	Margin mode

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "symbol": "BTC_USDT",
    "leverage": 10,
    "leverage_long": 10,
    "leverage_short": 10,
    "margin_mode": 1,
    "position_mode": 2
  }
}