Skip to main content
GET
/
v1
/
account
/
positions
Get positions
curl --request GET \
  --url https://joyride.exchange/api/v1/account/positions
[
  {
    "instrument_id": "SOL_USDC-28FEB26-150-C",
    "quantity": 1000,
    "avg_price": 1500000,
    "price_decimals": 6,
    "size_decimals": 3,
    "contract_size": 1
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.joyride.exchange/llms.txt

Use this file to discover all available pages before exploring further.

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

​
instrument_id
string
required
Example:

"SOL_USDC-28FEB26-150-C"

​
quantity
integer
required

Net position in millicontracts (positive = long, negative = short)

Example:

1000

​
avg_price
integer
required

Volume-weighted average entry price (USDC micros)

Example:

1500000

​
price_decimals
integer
required

Decimals applied to avg_price (always 6).

Example:

6

​
size_decimals
integer
required

Decimals applied to quantity (always 3).

Example:

3

​
contract_size
integer
required

Underlying units per contract — currently 1 for all listed instruments. Always read this from the response, never hard-code: future contracts may ship with a different multiplier. 0 indicates the instrument has rolled off and is no longer in the live engine.

Example:

1