Set Leverage/Margin Mode

Sets leverage and margin mode (Isolated or Cross) for a specific trading symbol and position.

It applies to individual positions identified by the symbol and slot parameters.

You can adjust the leverage level (from 1× up to the maximum allowed by the contract) and choose between:

• Isolated Margin — Margin is limited to the position itself; liquidation only affects that position.

• Cross Margin — Margin is shared across all open positions under the same account.

Proper leverage and margin configuration is essential before placing or modifying orders, as it directly affects margin requirements, liquidation risk, and available balance.

Authentication with a valid API key and trade permission scope is required.

Set Leverage / Order Mode

post

Required scopes

This endpoint requires the following scopes:

Authorizations

thirdPartyApiKeyAuth

api-keystringRequired

For third party retail API users

Body

application/json

symbolstringRequired

Trading symbol

Example: BTCUSDT.PERPPattern: ^[A-Z0-9]+(\.[A-Z0-9]+)?$

leverageinteger · min: 1 · max: 100Required

marginTypestring · enumRequired

Margin type

Possible values:

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

post

/api/v1/trade/leverage

HTTPcURLJavaScriptPython

POST /api/v1/trade/leverage HTTP/1.1
Host: trading-api.flipster.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "symbol": "BTCUSDT.PERP",
  "leverage": 1,
  "marginType": "CROSS"
}

{
  "position": {
    "symbol": "BTCUSDT.PERP",
    "slot": 1,
    "leverage": 25,
    "marginType": "CROSS",
    "positionSide": "LONG",
    "positionAmount": "###.###",
    "markPrice": "###.###",
    "unrealizedPnl": "###.###",
    "initialMargin": "###.###",
    "maintMargin": "###.###",
    "entryPrice": "###.###",
    "breakEvenPrice": "###.###",
    "liquidationPrice": "###.###",
    "totalFee": "###.###",
    "buyableBoosts": [
      {
        "duration": 1,
        "cost": "###.###"
      }
    ],
    "boostExpiryTimestamp": "1765975842095607088",
    "boostRemainingCount": 1,
    "boostRealizedPnl": "###.###"
  }
}