> ## Documentation Index > Fetch the complete documentation index at: https://docs.parlayx.com/llms.txt > Use this file to discover all available pages before exploring further. # List Positions > Returns the open Limitless positions held by the calling credential. ## OpenAPI ````yaml /openapi/v1.json get /v1/limitless/positions openapi: 3.0.0 info: title: ParlayX API version: 1.0.0 description: Aggregated prediction-market trading API servers: - url: https://api.parlayx.com security: [] tags: - name: Authentication description: Confirm your signing and read the server clock. - name: Discovery description: Browse sports, competitions, events, and markets. - name: Polymarket description: Submit and manage orders on Polymarket outcomes. - name: Kalshi description: Submit and manage orders on Kalshi markets. - name: ProphetX description: Submit and manage orders on ProphetX strikes. - name: Limitless description: Discover and trade Limitless markets. paths: /v1/limitless/positions: get: tags: - Limitless summary: List Positions description: Returns the open Limitless positions held by the calling credential. operationId: listLimitlessPositions parameters: - name: PX-Key-Id in: header required: true schema: type: string description: The key id issued for your signing keypair. - name: PX-Timestamp in: header required: true schema: type: string description: >- Unix seconds at signing, valid within 30 seconds of the server clock. - name: PX-Signature in: header required: true schema: type: string description: Ed25519 signature of the request - name: PX-Content-Sha256 in: header required: true schema: type: string description: >- Hex SHA-256 of the request body, or the SHA-256 of the empty string when there is no body. - schema: type: string description: Filter to a single Limitless outcome token. required: false name: tokenId in: query responses: '200': description: Positions found content: application/json: schema: $ref: '#/components/schemas/ListLimitlessPositionsResponse' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: The request was not authenticated content: application/json: schema: $ref: '#/components/schemas/AuthError' '403': description: The key is not permitted to perform this action content: application/json: schema: $ref: '#/components/schemas/AuthError' '429': description: >- The organization has exceeded its request rate; retry after the Retry-After interval content: application/json: schema: $ref: '#/components/schemas/AuthError' '500': description: Internal error content: application/json: schema: $ref: '#/components/schemas/ApiError' '503': description: Authentication is temporarily unavailable content: application/json: schema: $ref: '#/components/schemas/AuthError' components: schemas: ListLimitlessPositionsResponse: type: object properties: positions: type: array items: $ref: '#/components/schemas/LimitlessPosition' description: Open positions held by the calling credential, ordered by tokenId. required: - positions ApiError: type: object properties: error: type: object properties: code: $ref: '#/components/schemas/ApiErrorCode' message: type: string description: Plain-text explanation of the error. orderId: type: string format: uuid description: >- The affected order, present only on ORDER_RECONCILIATION_REQUIRED; read it back to determine whether it reached the venue. required: - code - message required: - error title: API Error AuthError: type: object properties: error: type: object properties: code: $ref: '#/components/schemas/AuthErrorCode' message: type: string description: Plain-text explanation of the error. required: - code - message required: - error title: Auth Error LimitlessPosition: type: object properties: tokenId: type: string description: Limitless outcome conditional-token id (raw integer string). example: >- 10999813436902295279687793687143205491693625423224337570276428722503253471600 marketSlug: type: string nullable: true minLength: 1 description: >- Market this outcome belongs to, or null when the position was built before the slug was recorded. example: doge-up-or-down-daily-1787500800 size: type: string description: >- Outcome shares this key's own fills account for, bounded by the pod's on-chain balance for the token so it cannot overstate what the pod holds. That bound is pod-wide and spans the pod's wallets, so where several keys trade one token it is not on its own a guarantee that a sell of this size fills. Shares acquired by an order whose fill was never recorded are not represented, so this can also read lower than the balance. example: '120.5' averagePrice: type: string nullable: true description: >- Weighted-average entry price of the holding in dollars, fees included, or null when it cannot be derived. example: '0.54' mark: type: string nullable: true description: >- Indicative current price per share in dollars from 0 to 1, or null when no price is available or the market is not known to be trading. example: '0.62' valueUsd: type: string nullable: true description: Current value of the holding in dollars, or null when mark is null. example: '74.40' unrealizedPnlUsd: type: string nullable: true description: >- Unrealized profit or loss in dollars, or null when mark is null. Taken against the whole cost basis, so where size is bounded by the on-chain balance this is not mark less averagePrice times size: shares the venue withheld are carried as the loss they are. example: '9.60' redeemable: type: boolean nullable: true description: >- Whether the market has resolved, so the position settles rather than trades, or null when resolution could not be established. required: - tokenId - marketSlug - size - averagePrice - mark - valueUsd - unrealizedPnlUsd - redeemable ApiErrorCode: type: string enum: - INVALID_REQUEST - NOT_FOUND - INSUFFICIENT_BALANCE - IDEMPOTENCY_CONFLICT - ORDER_NOT_CANCELLABLE - ORDER_RECONCILIATION_REQUIRED - RATE_LIMITED - INTERNAL_ERROR description: Stable identifier for the error category. AuthErrorCode: type: string enum: - UNAUTHORIZED - BAD_CONTENT_HASH - FORBIDDEN - RATE_LIMITED - AUTH_UNAVAILABLE description: Stable identifier for the error category. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.