> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kraken.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Open Positions
> Subscribe to open positions for your account
WSS
futures.kraken.com/ws/v1
open\_positions
This subscription feed publishes the open positions of the user account.
***
## Request
`subscribe` or `unsubscribe`
The requested subscription feed. Value: `open_positions`
The user API key.
The message that is received from a challenge request.
The signed challenge message with user API secret.
```json Example theme={null}
{
"event": "subscribe",
"feed": "open_positions",
"api_key": "CMl2SeSn09Tz+2tWuzPiPUjaXEQRGq6qv5UaexXuQ3SnahDQU/gO3aT+",
"original_challenge": "226aee50-88fc-4618-a42a-34f7709570b2",
"signed_challenge": "RE0DVOc7vS6pzcEjGWd/WJRRBWb54RkyvV+AZQSRl4+rap8Rlk64diR+Z9DQILm7qxncswMmJyvP/2vgzqqh+g=="
}
```
***
## Response Success
One of: `subscribed`, `subscribed_failed`, `unsubscribed`, `unsubscribed_failed`
The result.
The requested subscription feed. Value: `open_positions`
The user API key.
The message that is received from a challenge request.
The signed challenge message with user API secret.
```json Example theme={null}
{
"event": "subscribed",
"feed": "open_positions",
"api_key": "CMl2SeSn09Tz+2tWuzPiPUjaXEQRGq6qv5UaexXuQ3SnahDQU/gO3aT+",
"original_challenge": "226aee50-88fc-4618-a42a-34f7709570b2",
"signed_challenge": "RE0DVOc7vS6pzcEjGWd/WJRRBWb54RkyvV+AZQSRl4+rap8Rlk64diR+Z9DQILm7qxncswMmJyvP/2vgzqqh+g=="
}
```
***
## Response Snapshot
The subscribed feed.
The user account.
The subscription message sequence number.
The UTC time in milliseconds.
A list containing the user open positions.
The instrument (referred also as symbol or product\_id) of the order.
The size of the position.
The average entry price of the instrument.
The market price of the position instrument.
The index price of the position instrument.
The profit and loss of the position.
The mark price of the contract at which the position will be liquidated.
The percentage gain or loss relative to the initial margin used in the position. Formula: PnL/IM.
Unrealised funding from funding rate.
How leveraged the net position is in a given margin account. Formula: Position Value at Market / Portfolio Value.
The initial margin for the open position.
The initial margin for the open position and open orders of the same instrument.
The maintenance margin for the open position.
The profit currency for the position, not returned for inverse positions.
The maximum allowed fixed leverage for the position's instrument.
The time the most recent fill occurred for this position.
The option's implied volatility.
Delta, the option value's sensitivity to change in the underlying price.
Theta, the option value's sensitivity to the passage of time.
Gamma, delta's sensitivity to change in the underlying price.
Vega, the option value's sensitivity to change in volatility.
Rho, the option value's sensitivity to the interest rate.
```json Example theme={null}
{
"feed": "open_positions",
"account": "DemoUser",
"positions": [
{
"instrument": "PF_XRPUSD",
"balance": 500.0,
"pnl": -239.6506683474764,
"entry_price": 0.3985,
"mark_price": 0.4925844,
"index_price": 0.49756,
"liquidation_threshold": 0.0,
"effective_leverage": 0.17404676894304316,
"return_on_equity": -2.3609636135508127,
"initial_margin": 101.5054475943615,
"initial_margin_with_orders": 101.5054475943615,
"maintenance_margin": 50.75272379718075
},
{
"instrument": "PF_XBTUSD",
"balance": 0.04,
"pnl": 119.56244985549435,
"entry_price": 26911.75,
"mark_price": 29900.81124638736,
"index_price": 29900.47,
"liquidation_threshold": 9572.804662403718,
"effective_leverage": 0.31865408963748215,
"return_on_equity": 5.553450159107747,
"unrealized_funding": 0.0004114160669590132,
"initial_margin": 21.529400000000003,
"initial_margin_with_orders": 21.529400000000003,
"maintenance_margin": 10.764700000000001,
"pnl_currency": "USD"
},
{
"instrument": "OF_ETHUSD_240101_1000_C",
"balance": 0.04,
"pnl": 119.56244985549435,
"entry_price": 26911.75,
"mark_price": 29900.81124638736,
"index_price": 29900.47,
"return_on_equity": 5.553450159107747,
"iv": 0.3,
"delta": 0.5,
"gamma": 0.5,
"vega": 0.5,
"theta": 0.5,
"rho": 0.5
}
],
"seq": 4,
"timestamp": 1687383625330
}
```
***
## Response Error
Value: `error`
One of: `Invalid product id`, `Invalid feed`, `Json Error`
An error message.
```json Example theme={null}
{
"event": "error",
"message": "Invalid product id"
}
```