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 Positions

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": 1,
    "marginType": "CROSS",
    "positionSide": "LONG",
    "positionAmount": "text",
    "markPrice": "text",
    "unrealizedPnl": "text",
    "initialMargin": "text",
    "maintMargin": "text",
    "entryPrice": "text",
    "breakEvenPrice": "text",
    "liquidationPrice": "text",
    "totalFee": "text",
    "buyableBoosts": [
      {
        "duration": 1,
        "cost": "text"
      }
    ],
    "boostExpiryTimestamp": null,
    "boostRemainingCount": 1,
    "boostRealizedPnl": "text"
  }
]