Skip to main content
GET
Get user positions

Integration guide

Authorizations

x-app-id
string
header
required

Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.

Authorization
string
header
required

JWT access token from POST /auth/verify. Required with x-app-id on user routes. On the smart-route quote it is optional and turns a preview into an executable quote.

Query Parameters

cursor
string
limit
integer
Required range: 1 <= x <= 100
venueEventId
string
venueMarketId
string
status
enum<string>

active: shares still held. closed: fully sold or settled.

Available options:
active,
closed
categoryIds

Only positions on events in any of these categories (Category.ids, as /venue-events?categoryIds= takes; a league is a category). At most 20.

Maximum array length: 20
Minimum string length: 1
sort
enum<string>

realizedPnl: highest realized P&L first (e.g. biggest wins with status=closed). Default: stable group order. Live positions only.

Available options:
realizedPnl
mode
enum<string>
Available options:
live,
paper

Response

200

data
object[]
required

This page of results.

nextCursor
string | null
required

Pass as cursor to fetch the next page; null on the last page.

hasMore
boolean
required

true when another page exists.