Get User Pack Positions (Public)

Returns a profile’s public pack (parlay) positions by Ethereum address, newest first. Only ACTIVE, WON, and LOST positions are included.

GET /parlay/{account}/positions

Get public pack positions by account

cURL

curl --request GET \
  --url https://api.limitless.exchange/parlay/{account}/positions

200

{
  "data": [
    {
      "id": "<string>",
      "status": "ACTIVE",
      "stakeAmount": "<string>",
      "collateralDeposited": "<string>",
      "multiplierOffered": "<string>",
      "isClaimed": true,
      "createdAt": "<string>",
      "legs": [
        {
          "id": "<string>",
          "legIndex": 123,
          "marketId": 123,
          "conditionId": "<string>",
          "outcome": "YES",
          "priceAtCreation": "<string>",
          "resolutionStatus": "LOST",
          "marketSlug": "<string>",
          "marketTitle": "<string>",
          "marketImageUrl": "<string>",
          "group": {
            "id": 123,
            "slug": "<string>",
            "title": "<string>",
            "leagueName": "<string>",
            "homeTeam": "<string>",
            "awayTeam": "<string>",
            "homeScore": 123,
            "awayScore": 123,
            "startMatchTimestamp": 123
          },
          "leagueName": "<string>",
          "startMatchTimestamp": 123,
          "resolvedAt": "2023-11-07T05:31:56Z",
          "esportsPropType": "map_handicap",
          "outcomeLabels": [
            "<string>"
          ],
          "outcomeImageUrls": [
            "<string>"
          ]
        }
      ],
      "resolvedAt": "2023-11-07T05:31:56Z",
      "sourcePack": {
        "id": "<string>",
        "name": "<string>"
      }
    }
  ],
  "limit": 123,
  "page": 123,
  "totalPages": 123,
  "totalRows": 123
}

Returns a user’s pack (parlay) positions by Ethereum address, newest first. Public, no authentication required. The response includes only ACTIVE, WON, and LOST positions; internal lifecycle states never appear here.

When to use

Use this endpoint to render a packs positions list on a public profile view. Pass any wallet address; you do not need to be that user. For your own positions with private fields (wallet, transaction hashes, vig), use the authenticated positions endpoint instead.

Response contract

The 200 body is a paginated page: data, limit, page, totalPages, and totalRows.

• Each position carries its status, stake, multiplier, claim state (isClaimed), leg details, and the source pack it was bought from (null for custom packs).
• The public payload deliberately excludes wallet addresses, token IDs, transaction hashes, and vig fields.
• The API sorts positions by creation time, newest first.

Filtering and pagination

• status narrows the list to a single status: ACTIVE, WON, or LOST. Any other value returns 400 Bad Request. Omit it to return all three.
• The API clamps limit server-side to the range 1-50. The default is 20.
• offset defaults to 0. The API caps it at 10,000; a larger offset returns 400 Bad Request.
• totalRows always reflects the full matching count, while totalPages stops at the last browsable page under the offset cap.

Address handling

The account path parameter accepts a checksummed (EIP-55) or lowercase Ethereum address. A malformed address returns 400 Bad Request. An address with no profile returns 404 Not Found.

Caching

Responses carry Cache-Control: public, max-age=5, s-maxage=15, so CDN edges may serve a cached copy for up to 15 seconds. Status and claim state can trail the live database by roughly 30 seconds in the worst case. The authenticated owner endpoint is uncached.

Path Parameters

account · string · required

User Ethereum address

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

Query Parameters

limit · number · default: 20

Page size. Clamped server-side to the range 1-50.

Required range: 1 <= x <= 50

offset · number · default: 0

Number of positions to skip. Offsets above 10000 return 400.

Required range: 0 <= x <= 10000

status · enum<string>

Filter to a single status. Omit to return all public statuses.

Available options: ACTIVE, WON, LOST

Response

200

application/json

Paginated public pack positions, newest first

data · object[] · required

Show child attributes

limit · number · required

Effective page size (capped server-side)

page · number · required

1-based page index derived from offset/limit

totalPages · number · required

Capped at the last browsable page (offset 10000)

totalRows · number · required

Full matching count, not capped