Change Leverage

Change the leverage for a specified trading pair. In hedge mode, long and short leverage can be configured separately.

API Information

• Method: PUT
• Path: /fapi/v1/configs/{symbol}/leverage
• 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
leverage	integer	No	Leverage (cross mode)
leverage_long	integer	No	Long leverage
leverage_short	integer	No	Short leverage

Request Example

PUT /fapi/v1/configs/BTC_USDT/leverage

{
  "leverage": 20,
  "leverage_long": 20,
  "leverage_short": 20
}

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.leverage	integer	Leverage
data.leverage_long	integer	Long leverage
data.leverage_short	integer	Short leverage
data.margin_mode	integer	Margin mode
data.position_mode	integer	Position mode

Response Example

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