Adjust Margin

Adjusts the margin amount for an existing position by adding or reducing margin funds.

This endpoint allows users to modify the isolated margin allocated to an existing position.

You can either add or reduce margin for a specific symbol and slot (position index) by specifying the amount and type parameters:

• type = 1 → Add margin

• type = 2 → Reduce margin

Adjusting margin affects the liquidation price and available balance.

Use this endpoint to manage position risk, increase leverage exposure, or free up collateral for other trades.

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

Adjust Margin

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]+)?$

amountstringRequired

Precise, high-resolution number type.

Example: ###.###

typeinteger · enumRequired

1=Add, 2=Reduce

Possible values:

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

post

/api/v1/trade/margin

HTTPcURLJavaScriptPython

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

{
  "symbol": "BTCUSDT.PERP",
  "amount": "###.###",
  "type": 1
}

{
  "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": "###.###"
  }
}