v1

latestOpenAPI 3.0.32026-07-267278168.1 KB

Positions

Get Positions

Returns all open positions for the authenticated account. For how positions and balances work, see Positions and balances.

get/v1/perps/positions

Response

List of positions

successboolean required

Whether the request was successful

errorstring

Error message, present only on failure

error_codestring

Semantic error code. See each endpoint's error responses for the specific codes it can return.

deprecatedstring

Deprecation notice, if applicable

Example response

{
  "success": true,
  "result": [
    {
      "market": "AAPL-USD.P",
      "direction": "short",
      "netQuantity": "1.5489",
      "averageEntryPrice": "20566.84",
      "usedMargin": "2566.84",
      "unrealizedPnl": "-900.54",
      "markPrice": "20000.54",
      "liquidationPrice": "9000.87",
      "bankruptcyPrice": "6000.11",
      "maintenanceMargin": "1500.22",
      "notionalValue": "30000.00",
      "leverage": "10.0",
      "netFundingSinceNeutral": "-12.34",
      "returnOnEquity": "-0.35",
      "stopLossTriggerPrice": "18000.00",
      "takeProfitTriggerPrice": "25000.00"
    }
  ]
}