v1

latestOpenAPI 3.1.12026-07-23195454.2 KB
get-closed-positions

Get closed positions

Returns a paginated list of historically closed outcome token positions for a wallet. Includes realised PnL, whether the position was a winner, claim/finalisation status, and early-resolution eligibility. When claimed=false (claimable snapshot), max limit is 500; otherwise max limit is 50.

get/api/v1/market-data/closed-positions

Query parameters

userstring required

Wallet address

marketstring

Comma-separated market addresses to filter by

question_idstring

Comma-separated question IDs to filter by

claimedstring

Claim status filter. 'true' returns positions the user has already claimed. 'false' returns positions that still need claiming (finalised winning outcomes the user held to resolution but has not yet claimed). Omit to include all closed positions, including those exited by trading before finalisation.

orderstring

Sort field: realized_pnl (default), finalised_at, closed_at

ascendingboolean

Sort ascending (default false = descending)

limitinteger

Limit (default 10; max 50, or max 500 when claimed=false)

offsetinteger

Offset (default 0, max 100000)

Response

OK