Get Position Info

Retrieves detailed information about the user’s open positions across all trading symbols.

This endpoint returns a list of the user’s current open positions, including symbol, position size, leverage, entry price, unrealized PnL, and liquidation price. It provides real-time visibility into margin usage and risk exposure for each trading pair. Use this endpoint to monitor active positions, calculate portfolio value, or manage position-related operations such as adjusting leverage or closing trades.

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

Get Position Info

get

Required scopes

This endpoint requires the following scopes:

Authorizations

thirdPartyApiKeyAuth

api-keystringRequired

For third party retail API users

Query parameters

symbolstringOptional

Trading symbol

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

Responses

200

OK

application/json

get

/api/v1/account/position

HTTPcURLJavaScriptPython

GET /api/v1/account/position HTTP/1.1
Host: trading-api.flipster.io
api-key: YOUR_API_KEY
Accept: */*

200

OK

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