private/get_positions

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.

Scope: trade:read

Try in API console

cURL

cURL

curl --request GET \
  --url https://test.deribit.com/api/v2/private/get_positions \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": 2236,
  "method": "private/get_positions",
  "params": {
    "currency": "BTC",
    "kind": "future"
  }
}
'

200

{
  "jsonrpc": "2.0",
  "id": 2236,
  "result": [
    {
      "average_price": 7440.18,
      "delta": 0.006687487,
      "direction": "buy",
      "estimated_liquidation_price": 1.74,
      "floating_profit_loss": 0,
      "index_price": 7466.79,
      "initial_margin": 0.000197283,
      "instrument_name": "BTC-PERPETUAL",
      "interest_value": 1.7362511643080387,
      "kind": "future",
      "leverage": 34,
      "maintenance_margin": 0.000143783,
      "mark_price": 7476.65,
      "open_orders_margin": 0.000197288,
      "realized_funding": -1e-8,
      "realized_profit_loss": -9e-9,
      "settlement_price": 7476.65,
      "size": 50,
      "size_currency": 0.006687487,
      "total_profit_loss": 0.000032781
    }
  ]
}

Query Parameters

currency · enum<string>

Currency name or "any" if don't care

Available options: BTC, ETH, USDC, USDT, EURR, any

Example:

"BTC"

kind · enum<string>

Kind filter on positions Instrument kind: "future", "option", "spot", "future_combo", "option_combo"

Available options: future, option, spot, future_combo, option_combo

Example:

"future"

subaccount_id · integer

The user id for the subaccount

Response

200

application/json

Success response

jsonrpc · enum<string> · required

The JSON-RPC version (2.0)

Available options: 2.0

result · object[] · required

Hide child attributes

result. instrument_name · string · required

Unique instrument identifier

Example:

"BTC-PERPETUAL"

result. kind · enum<string> · required

Instrument kind: "future", "option", "spot", "future_combo", "option_combo"

Available options: future, option, spot, future_combo, option_combo

result. average_price · number · required

Average price of trades that built this position

result. direction · enum<string> · required

Direction: buy, sell or zero

Available options: buy, sell, zero

result. mark_price · number · required

Current mark price for position's instrument

result. delta · number · required

Delta parameter

result. index_price · number · required

Current index price

result. initial_margin · number · required

Initial margin

result. maintenance_margin · number · required

Maintenance margin

result. settlement_price · number · required

Optional (not added for spot). Last settlement price for position's instrument 0 if instrument wasn't settled yet

result. total_profit_loss · number · required

Profit or loss from position

result. floating_profit_loss · number · required

Floating profit or loss

result. realized_profit_loss · number · required

Realized profit or loss

result. size · number · required

Position size for futures size in quote currency (e.g. USD), for options size is in base currency (e.g. BTC)

result. estimated_liquidation_price · number · required

Estimated liquidation price, added only for futures, for users with segregated_sm margin model

result. open_orders_margin · number · required

Open orders margin

result. gamma · number

Only for options, Gamma parameter

result. vega · number

Only for options, Vega parameter

result. theta · number

Only for options, Theta parameter

result. size_currency · number

Only for futures, position size in base currency

result. average_price_usd · number

Only for options, average price in USD

result. floating_profit_loss_usd · number

Only for options, floating profit or loss in USD

result. leverage · integer

Current available leverage for future position

result. realized_funding · number

Realized Funding in current session included in session realized profit or loss, only for positions of perpetual instruments

result. interest_value · number

Value used to calculate realized_funding (perpetual only)

id · integer

The id that was sent in the request