Skip to main content

Set Leverage

Set the leverage

Trading products covered: Spot / Linear/Inverse

HTTP Request

POST /cloud/trade/v3/position/set-leverage

Request Parameters

ParameterRequiredTypeComments
categorytruestringProduct type: spot, linear, inverse
symboltruestringSymbol name
buyLeveragetruestring[1, max leverage risk limit].
  • One-way mode: buyLeverage must equal sellLeverage
  • Hedge mode:
    • Isolated margin: buyLeverage can be different from sellLeverage
    • Cross margin: buyLeverage must equal sellLeverage
sellLeveragetruestring[1, max leverage of corresponding risk limit]. Note: Under one-way mode, buyLeverage must be the same as sellLeverage

Response Parameters

None

Request Example

POST /cloud/trade/v3/position/set-leverage HTTP/1.1
Host: openapi-testnet.zoomex.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672281605082
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"category": "linear",
"symbol": "BTCUSDT",
"buyLeverage": "6",
"sellLeverage": "6"

}

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {},
"retExtInfo": {},
"time": 1672281607343
}