My Positions

GET /v1/positions/me

All non-zero positions for the caller, ordered by symbol. Returns [] if the user holds no positions.

Auth: Authorization: Bearer <session_token> (see place-order). The caller is the session's user — there is no user_id parameter. limit / status query params are accepted but ignored.

Request

GET /v1/positions/me
Authorization: Bearer <session_token>

Response — 200

[
  {
    "user_id": "5cfb031b-5936-4467-9533-cd2df576dbb8",
    "symbol": "BTC-PERP",
    "qty": "0.001",
    "entry_price": "76500.00",
    "locked_margin": "7.65",
    "realized_pnl": "0.5234",
    "take_profit_price": "78000",
    "stop_loss_price": null,
    "liquidation_price": "69195.9798995",
    "funding": "-0.0096",
    "leverage": 10
  }
]

Field	Type	Notes
take_profit_price / stop_loss_price	string or null	Armed TP/SL trigger price for this position; null when none is armed.
liquidation_price	string or null	Isolated-margin estimate at a 0.5% maintenance-margin ratio; null when no positive solution exists.
funding	string	Cumulative funding received on this symbol (negative = paid).
leverage	integer	Leverage the position is margined at.

Errors (plain-text body): 401 missing/invalid session token, 500 DB error.