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

symbolstringRequired

Trading symbol

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

slotintegerRequired

Position slot

leverageintegerRequiredExample: 25

marginTypestring · enumRequired

Margin type

Possible values:

positionSidestring · enum · nullableOptional

Pswap order side

Possible values:

positionAmountstring · nullableOptional

the current size of the position denominated in the base asset.

Example: ###.###

markPricestring · nullableOptional

the current market mark price used for PnL calculations and liquidation triggers.

Example: ###.###

unrealizedPnlstring · nullableOptional

the floating profit or loss of the current open position.

Example: ###.###

initialMarginstring · nullableOptional

the amount of margin reserved to keep the position open.

Example: ###.###

maintMarginstring · nullableOptional

the minimum margin required to prevent liquidation.

Example: ###.###

entryPricestring · nullableOptional

the average price at which the position was opened.

Example: ###.###

breakEvenPricestring · nullableOptional

the price at which the position would have zero PnL, accounting for fees.

Example: ###.###

liquidationPricestring · nullableOptional

the price level at which the position will be automatically liquidated.

Example: ###.###

totalFeestring · nullableOptional

the total trading fees accumulated for this position.

Example: ###.###

boostExpiryTimestampstring · nullableOptional

the expiration timestamp for any active profit boost.

Example: 1765975842095607088

boostRemainingCountintegerOptional

the number of remaining profit boosts available for use.

boostRealizedPnlstring · nullableOptional

the realized profit and loss specifically attributed to applied profit boosts.

Example: ###.###

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