Skip to main content
GET
/
v1
/
account
/
positions-with-metrics
Get positions with metrics
curl --request GET \
  --url https://joyride.exchange/api/v1/account/positions-with-metrics
[
  {
    "instrument_id": "SOL_USDC-28FEB26-150-C",
    "quantity": 1000,
    "avg_price": 1500000,
    "mid_price": 1700000,
    "current_value": 1700000,
    "pnl": 200000,
    "pnl_percent": 13.33,
    "breakeven": 1500000
  }
]

Headers

​
x-wallet
string

Wallet address — primary user identification method

​
x-device-id
string

Device identifier — mobile fallback when x-wallet is not set

Query Parameters

​
wallet
string

Wallet address — fallback if neither x-wallet nor x-device-id headers are set

Response

200 - application/json

Array of positions with P&L metrics

​
instrument_id
string
required
Example:

"SOL_USDC-28FEB26-150-C"

​
quantity
integer
required

Net position in millicontracts

Example:

1000

​
avg_price
integer
required

Average entry price (USDC micros)

Example:

1500000

​
mid_price
integer
required

Current mid price (USDC micros, 0 if no quotes)

Example:

1700000

​
current_value
integer
required

Current position value (USDC micros, 0 if no quotes)

Example:

1700000

​
pnl
integer
required

Unrealized P&L (USDC micros, 0 if no quotes)

Example:

200000

​
pnl_percent
number
required

P&L as a percentage

Example:

13.33

​
breakeven
integer
required

Breakeven price (USDC micros)

Example:

1500000