Skip to main content
Call client.portfolio.positions() or its top-level shortcut client.positions() to retrieve all open positions held by a subaccount. The response contains one record per instrument with details about the current holding size, average entry cost, and unrealized profit and loss. Use this endpoint to monitor exposure across the prediction markets your subaccount is active in.

Method

Endpoint: GET /v1/positions

Example

Parameters

string
required
The subaccount whose open positions to retrieve.

Response

The endpoint returns a list of position objects, one per instrument with a non-zero holding. Common fields:
integer
The venue-specific instrument identifier.
"BUY" | "SELL"
Direction of the position.
string
Current open quantity as a decimal string.
string
Average entry price (cost basis) as a decimal string.
string
Mark-to-market unrealized profit and loss as a decimal string.

Notes

To monitor position changes in real time, subscribe to the /v1/ws/positions WebSocket stream. See the WebSocket overview for connection details.
Positions reflect holdings at the subaccount level. If you operate multiple subaccounts, call this endpoint once per subaccount to get a full portfolio view.