Retrieves all open positions for the authenticated account. Returns position details including size, average entry price, mark price, unrealized P&L, initial margin, maintenance margin, and other position-related information.

Results can be filtered by currency and instrument kind (future, option, etc.). To retrieve positions for a specific subaccount, use the subaccount_id parameter. Spot holdings are balances, not positions — kind: "spot" is rejected. Prefer currency: "any" over looping currencies.

📖 Related Articles:

• Using the currency Parameter
• Spot Trading: Deribit and Coinbase-Routed Instruments

Scope: trade:read

Try in API console

{
  "result": [
    {
      "instrument_name": "BTC-PERPETUAL",
      "user_id": 57874
    }
  ]
}