List open positions
Lists the authenticated account’s open positions.
Endpoint
GET /api/v1/positions[?portfolio_index=0&market=BTC-PERP]
Authentication
Requires the X-API-KEY header. An account-wide key spans every subaccount; a pinned key is
limited to its own. Optionally narrowed by portfolio_index and/or market.
Returns
200 OKwith a (possibly empty) array ofPositionResponse.400 Bad Requestifmarketis provided but invalid.
Authorizations
Base64-encoded API key issued by POST /api/v1/api-keys.
Query Parameters
x >= 0x >= 0Response
Open positions
A system-generated unique identifier for an account.
x >= 0A unique identifier for a portfolio within a subaccount.
x >= 0A unique identifier for a subaccount within an account.
x >= 0The average entry price of the position in quote asset units
"64998.50"
The unique identifier of the position
"0190b6c2-7e4a-7c3b-9f21-2b6a1c4e5d8f"
The symbol of the market (e.g. BTC-PERP)
"BTC-PERP"
The net funding accrued on this position in USDC
"-1.35"
The current size of the position in base asset units
"0.25"
The side of the position (Long or Short)
LONG, SHORT