Get closed positions

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

Get closed positions

get

Returns a paginated list of historically closed outcome token positions for a wallet. Includes realised PnL, whether the position was a winner, and claim/finalisation status.

Query parameters

userstringRequired

Wallet address

marketstringOptional

Comma-separated market addresses to filter by

question_idstringOptional

Comma-separated question IDs to filter by

claimedstringOptional

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.

limitintegerOptional

Limit (default 10, max 50)

offsetintegerOptional

Offset (default 0, max 100000)

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

get

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

HTTPcURLJavaScriptPython

GET /api/v1/market-data/closed-positions?user=text HTTP/1.1
Host: rest.ft.42.space/
Accept: */*

{
  "data": [
    {
      "avgPrice": 1,
      "closedAt": "text",
      "costBasis": 1,
      "curPrice": 1,
      "dispute": {
        "deadlineAt": "text",
        "isWindowOpen": true,
        "latestResolveId": 1,
        "resolvedAt": "text",
        "viewerDisputeId": 1,
        "windowHours": 1
      },
      "isClaimed": true,
      "isFinalized": true,
      "isWinner": true,
      "market": {
        "collateralDecimals": 1,
        "startDate": "text"
      },
      "marketAddress": "text",
      "outcome": {
        "image": "text",
        "index": 1,
        "mintedQuantity": 1,
        "name": "text",
        "payout": 1,
        "symbol": "text"
      },
      "question": {
        "description": "text",
        "endDate": "text",
        "image": "text",
        "questionId": "text",
        "resolvedAnswer": "text",
        "title": "text",
        "winningOutcomes": "text"
      },
      "questionId": "text",
      "realizedPnl": 1,
      "size": 1,
      "tokenId": "text",
      "userAddress": "text"
    }
  ],
  "pagination": {
    "hasMore": true,
    "totalResults": 1
  }
}