Set Leverage

Set the leverage for long and short positions of a specific trading symbol.

HTTP Request

POST /api/v1/future/account/set-leverage

Request Parameters

Parameter	Type	Required	Description
symbol	string	Yes	Trading pair symbol (e.g., BTCUSDT)
longLeverage	number	No	Leverage for long positions
shortLeverage	number	No	Leverage for short positions

Request Example

curl -X POST "https://open-api.bydoxe.com/api/v1/future/account/set-leverage" \
  -H "ACCESS-KEY: your-api-key" \
  -H "ACCESS-SIGN: your-signature" \
  -H "ACCESS-PASSPHRASE: your-passphrase" \
  -H "ACCESS-TIMESTAMP: 1659076670000" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "BTCUSDT",
    "longLeverage": 25,
    "shortLeverage": 20
  }'

Response Parameters

Parameter	Type	Description
code	string	Response code
msg	string	Response message
requestTime	number	Request timestamp in milliseconds
data	object	Leverage change data
> symbol	string	Trading pair symbol
> marginCoin	string	Margin coin (e.g., USDT)
> longLeverage	string	Updated leverage for long positions
> shortLeverage	string	Updated leverage for short positions
> marginMode	string	Current margin mode: "CROSS" or "ISOLATED"

Response Example

Success Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1732000000000,
  "data": {
    "symbol": "BTCUSDT",
    "marginCoin": "USDT",
    "longLeverage": "25",
    "shortLeverage": "20",
    "marginMode": "CROSS"
  }
}

Error Codes

Code	Message
40034	symbol does not exist
40001	Long or short leverage are required
40001	Long leverage is too high
40001	Short leverage is too high
40001	Cannot set high long leverage for the position currently opened.
40001	Cannot set high short leverage for the position currently opened.
40001	dynamic error from changeLeveragePosition