Pre Set Leverage

Description

Preview the impact of adjusting the leverage of a specified symbol. This endpoint returns the estimated maximum tradable amount and required margin after the leverage change, without actually applying the change.

HTTP Request

• GET /api/v3/account/pre-set-leverage
• Rate limit: 10/sec/UID
• Permission: UTA mgt. (read)

Request

curl "https://api.bitget.com/api/v3/account/pre-set-leverage?category=USDT-FUTURES&symbol=BTCUSDT&marginMode=crossed&leverage=10" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*" \
   -H "ACCESS-PASSPHRASE:*" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale:en-US" \
   -H "Content-Type: application/json"

Request Parameters

Parameter	Type	Required	Description
category	String	Yes	Product type MARGIN Margin trading USDT-FUTURES USDT futures COIN-FUTURES Coin-M futures USDC-FUTURES USDC futures
symbol	String	No	Symbol name Required when changing the leverage of a futures symbol
coin	String	No	Coin name Required when changing the leverage for margin trading
marginMode	String	Yes	Position mode isolated Isolated margin crossed Cross margin
leverage	String	No	Leverage multiple Applicable to cross margin mode Applicable to isolated margin one-way position scenario Applicable to isolated margin two-way position scenario when the same leverage is set for both directions
longLeverage	String	No	Long position leverage Only applicable when using isolated margin with two-way position mode and different leverage for each direction In two-way position mode, if both leverage and longLeverage are passed, longLeverage takes effect and leverage is ignored
shortLeverage	String	No	Short position leverage Only applicable when using isolated margin with two-way position mode and different leverage for each direction In two-way position mode, if both leverage and shortLeverage are passed, shortLeverage takes effect and leverage is ignored

Response

{
  "code": "00000",
  "msg": "success",
  "requestTime": 1740000000000,
  "data": {
    "estMaxOpen": "1.2345",
    "estMaxBorrowable": "100",
    "requiredMargin": "200.5",
    "marginChange": "10.5"
  }
}

Response Parameters

Parameter	Type	Description
estMaxOpen	String	Estimated maximum tradable amount after adjustment Returned for futures
estMaxBorrowable	String	Estimated maximum borrowable amount after adjustment Returned for margin trading; denominated in coin
requiredMargin	String	Required margin, denominated in USD
marginChange	String	Margin usage change after adjustment A positive value means an increase, a negative value means a decrease