Get open positions

GET /api/v1/market-data/positions

Get open positions

get

Returns a paginated list of currently open outcome token positions for a wallet (current_quantity > 0 AND is_claimed = FALSE). Includes unrealised PnL, cost basis, current value, held quantity, last block timestamp, early-resolution eligibility, market lifecycle status (same values as /market-data/status), and outcome details. Optionally filter by market or question ID.

Query parameters

userstringRequired

Wallet address

marketstringOptional

Comma-separated market addresses to filter by

question_idstringOptional

Comma-separated question IDs to filter by

exclude_tagsstringOptional

Comma-separated question tags to exclude (case-insensitive; max 20)

orderstringOptional

Sort field: size (default), last_traded, updated_at

ascendingbooleanOptional

Sort ascending (default false = descending)

limitintegerOptional

Limit (default 100, max 1000)

offsetintegerOptional

Offset (default 0, max 10000)

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

get/api/v1/market-data/positions

HTTPcURLJavaScriptPython

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

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