Skip to main content
POST
All Positions

Body

application/json
page
object
required
userId
object
required

User wallet address

filter
(Numeric · object | ID · object | Boolean · object | Group · object)[]

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

Minimum array length: 1

A single field condition. in/notIn take an array of values; matches/notMatches take one search term.

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: Event (embedding + full-text relevance).

Response

List of All Positions rows

avgBuyPrice
number<double>

Average buying price of the shares

event
Event · object

Resolved Event row.

exitPrice
number<double>

Average selling price

invested
number<double>

Total USD amount invested in the position.

marketClosed
boolean

Market Closed

pnl
number<double>

Total profit and loss

positions
Positions · object[]

Per-position breakdown within the event, bought, bought shares, avg buy price, pnl, realized/unrealized pnl and roi, summed across every matching wallet (so a position held by N cohort users collapses to one entry). Serialized as a JSON array of objects.

roi
number<double>

Return on investment percentage

shares
number<double>

Total shares bought

unrealizedPnl
number<double>

Unrealized profit and loss for currently held shares

unrealizedShares
number<double>

Number of currently held shares