Change Margin Mode

Change the margin mode (cross / isolated) for a specified trading pair.

API Information

• Method: PUT
• Path: /fapi/v1/configs/{symbol}/margin-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
margin_mode	integer	Yes	Margin mode: 1=isolated, 2=cross

Request Example

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

{
  "margin_mode": 1
}

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.margin_mode	integer	Margin mode: 1=isolated, 2=cross
data.leverage / leverage_long / leverage_short	integer	Leverage configuration
data.position_mode	integer	Position 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
  }
}