Update Leverage

Update the leverage multiplier and margin mode for a specified futures trading pair.

API Information

• Method: POST
• Path: /api/v1/futures/open-api/account/leverage

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Futures trading pair, e.g. AAPL
leverage	string	Yes	Leverage multiplier, e.g. "10"
marginMode	int	Yes	Margin mode: 1=Cross, 2=Isolated

Request Example

{
  "symbol": "AAPL",
  "leverage": "10",
  "marginMode": 1
}

Response Fields

Field	Type	Description
code	int	Status code, 0 indicates success
data.symbol	string	Futures trading pair
data.leverage	string	Effective leverage multiplier
data.marginMode	int	Effective margin mode

Response Example

{
  "code": 0,
  "data": {
    "symbol": "AAPL",
    "leverage": "10",
    "marginMode": 1
  }
}

Error Codes

Business errors are returned with HTTP 200. Use the body code field to identify the specific error.

code	Description
3000	Trading pair not found
8007	Insufficient initial margin to adjust leverage
8008	Failed to adjust leverage
8011	Leverage error
8014	Cannot reduce leverage while holding an isolated position