Skip to main content
GET
Get Positions
For real-time position updates, use the WebSocket API — subscribe to subscribe_positions.
status: RESOLVED and winningOutcomeIndex indicate that the winning outcome is known in the API response. They do not guarantee that the underlying conditional token payout has already been settled on-chain or that the position is immediately redeemable. See Programmatic API - Lifecycle after a trade.
Split-resolved positions. A resolved position with winningOutcomeIndex: null and a non-null payoutNumerators array on its market is a payout split (for example [50, 50] for 50/50). Both YES and NO holdings on that market are redeemable at the ratio through POST /portfolio/redeem in a single transaction.
rewards object: reward-field semantics (as currently computed). All reward amounts are 1e6-scaled USDC integers. Divide by 1,000,000 to get dollars ("11458" = $0.011458).
  • todaysRewards — despite the schema description, this is not a calendar-day total. It reflects the latest processed reward epoch, and epochs run once per minute, so read it as “rewards earned in the last completed minute.”
  • totalUserRewardsLastEpoch — the same one-epoch window, so it currently carries the same value as todaysRewards.
  • totalUnpaidRewards — everything accrued since your last payout, across all markets and epochs. Use this field for balances. Expect it to be much larger than the other two.
Payouts run once a day at 22:30 UTC and pay the full unpaid balance. There is no minimum, and sub-cent amounts are included. See LP Rewards.

Authorizations

Authorization
string
header
required

JWT token for API access (alternative to cookie auth)

Response

Complete portfolio positions with summary

rewards
object
required

Rewards information for the portfolio

points
number
required

User points

Example:

123

accumulativePoints
number
required

User accumulative points

Example:

456

amm
object[]
required

List of AMM positions

clob
object[]
required

List of CLOB positions

group
object[]

Grouped CLOB positions (if enabled)