Skip to main content
POST
User Position

Authorizations

X-Api-Key
string
header
required

API key issued for programmatic access.

Body

application/json
page
object
required
filter
object[]

Filters to apply, combined with AND. Use a group for OR.

Minimum array length: 1

A single condition, or a group combining conditions with AND/OR.

orderBy
object[]

Sort keys in priority order; the first is the primary sort. Defaults to the table's configured ranking when omitted.

searchKey
string

Free-text search over: User (prefix match/full-text search).

Response

List of User Position rows

avgBuyingPrice
number<double>

Average buying price per share

avgSellingPrice
number<double>

Average selling price per share

currentlyHeldShares
number<double>

Shares currently held

eventId
integer<int32>

Prediction event ID

firstTradeTimestamp
string<date-time>

Timestamp of the first trade

latestTradeTimestamp
string<date-time>

Timestamp of the latest trade

marketId
integer<int32>

Prediction market ID

positionId
integer<int32>

The position bought/sold in a market.

positionSize
number<double>

Size of Position

realizedAvgBuyingPrice
number<double>

Average buying price per share for sold shares

realizedPnl
number<double>

Realized profit and loss

realizedPnlPercentage
number<float>

Realized PnL as a percentage

seriesId
integer<int32>

Series identifier

tagIds
integer<int32>[]

Tags associated with the event

totalBoughtShares
number<double>

Total shares bought

totalBoughtUsd
number<double>

Total USD spent buying

totalBuyCost
number<double>

Total cost basis for sold shares

totalSoldShares
number<double>

Total shares sold

totalSoldUsd
number<double>

Total USD received from selling

totalTrades
integer<int32>

Total number of trades done by the user for this position.

unrealizedUsd
number<double>

Unrealized USD value aka unrealized value

userId
string

User wallet address