> ## 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 Orders

> Returns a paginated list of ProphetX orders.



## OpenAPI

````yaml /openapi/v1.json get /v1/prophetx/orders
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/prophetx/orders:
    get:
      tags:
        - ProphetX
      summary: List Orders
      description: Returns a paginated list of ProphetX orders.
      operationId: listProphetXOrders
      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
            minLength: 1
            description: Filter to orders on a single ProphetX strike.
          required: false
          name: strikeId
          in: query
        - schema:
            type: string
            enum:
              - PENDING
              - SUBMITTED
              - OPEN
              - FILLED
              - CANCELLED
              - REJECTED
            description: >-
              Filter to orders in a single lifecycle status. Matches the order's
              state at the venue, so an immediate-or-cancel order still live
              there matches `OPEN` while reporting `SUBMITTED`.
          required: false
          name: status
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
            description: >-
              Max results to return (1-100). Applies to the first page only;
              ignored when a pageToken is supplied (the token's encoded page
              size wins).
            example: 20
          required: false
          name: pageSize
          in: query
        - schema:
            type: string
            minLength: 1
            description: >-
              Opaque cursor from a previous response's `nextPageToken`. Encodes
              the page size so it does not need to be re-sent. Omit to fetch the
              first page.
          required: false
          name: pageToken
          in: query
      responses:
        '200':
          description: Orders found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListProphetXOrdersResponse'
        '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:
    ListProphetXOrdersResponse:
      type: object
      properties:
        orders:
          type: array
          items:
            $ref: '#/components/schemas/ProphetXOrderView'
          description: Page of orders.
        nextPageToken:
          type: string
          nullable: true
          description: >-
            Opaque cursor for the next page, or null when there are no more
            results.
      required:
        - orders
        - nextPageToken
    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
    ProphetXOrderView:
      type: object
      properties:
        queuePosition:
          type: string
          nullable: true
          description: >-
            Queue position is unavailable for this venue and is returned as
            null.
        orderId:
          type: string
          format: uuid
          description: Issued order id.
          example: abd80630-5c89-437f-980e-47936f518ec2
        strikeId:
          type: string
          minLength: 1
          description: >-
            The ProphetX strike to trade, which identifies both the market and
            the side.
          example: ab39fb9a7b4eb6a26d7e26f885c601c1
        price:
          $ref: '#/components/schemas/ProphetXPrice'
        quantity:
          type: number
          minimum: 0
          exclusiveMinimum: true
          description: Stake in account currency units.
          example: 25
        postOnly:
          type: boolean
          description: Whether the order was placed as add-liquidity-only.
          example: false
        timeInForce:
          oneOf:
            - $ref: '#/components/schemas/GtcTimeInForce'
            - $ref: '#/components/schemas/ProphetXFokTimeInForce'
            - $ref: '#/components/schemas/ProphetXGtdTimeInForce'
          discriminator:
            propertyName: type
            mapping:
              GTC: '#/components/schemas/GtcTimeInForce'
              FOK: '#/components/schemas/ProphetXFokTimeInForce'
              GTD: '#/components/schemas/ProphetXGtdTimeInForce'
          description: Requested execution policy when recorded with the order.
        cancellationReason:
          type: string
          enum:
            - EXPIRED
          description: Indicates cancellation initiated by the requested expiry.
        status:
          $ref: '#/components/schemas/TradingOrderStatus'
        venueOrderId:
          type: string
          nullable: true
          description: ProphetX order id, or null until the venue acknowledges the order.
          example: 9f1a2b3c4d5e6f708192a3b4c5d6e7f8
        createdAt:
          type: string
          description: Time the order was created, in ISO-8601.
          example: '2026-08-29T12:00:00.000Z'
        updatedAt:
          type: string
          description: Time the order was last updated, in ISO-8601.
          example: '2026-08-29T12:05:00.000Z'
        filledQuantity:
          type: number
          nullable: true
          description: >-
            Total matched stake in dollars, from the fill ledger while the order
            is working and from the terminal summary once it closes, or null
            when no fills have been recorded.
          example: 10
      required:
        - orderId
        - strikeId
        - price
        - quantity
        - postOnly
        - status
        - venueOrderId
        - createdAt
        - updatedAt
        - filledQuantity
      title: Order
    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.
    ProphetXPrice:
      type: string
      description: >-
        Price in dollars per share, greater than 0 and less than 1, with at most
        six decimal places.
      example: '0.413223'
    GtcTimeInForce:
      type: object
      properties:
        type:
          type: string
          enum:
            - GTC
      required:
        - type
      additionalProperties: false
      description: 'Good til cancelled: rest at price until filled or cancelled.'
      title: GoodTillCancelled
    ProphetXFokTimeInForce:
      type: object
      properties:
        type:
          type: string
          enum:
            - FOK
      required:
        - type
      additionalProperties: false
      description: >-
        The venue's fill-or-kill strategy: an order with no match is cancelled
        at the venue after about two seconds.
      title: FillOrKill
    ProphetXGtdTimeInForce:
      type: object
      properties:
        type:
          type: string
          enum:
            - GTD
        expiresAt:
          type: string
          format: date-time
          description: Absolute UTC deadline for cancellation of the remaining stake.
      required:
        - type
        - expiresAt
      additionalProperties: false
      description: >-
        Rests until the stated time, when ParlayX cancels whatever stake is
        still open.
      title: GoodTilDate
    TradingOrderStatus:
      type: string
      enum:
        - PENDING
        - SUBMITTED
        - OPEN
        - FILLED
        - CANCELLED
        - REJECTED
      description: >-
        Order lifecycle status.


        | Status | Meaning |

        | --- | --- |

        | `PENDING` | Accepted, not yet sent to the venue. |

        | `SUBMITTED` | At the venue, outcome not yet known. Either not yet
        acknowledged, or an immediate-or-cancel order acknowledged but not yet
        settled. |

        | `OPEN` | Resting on the venue, and cancellable. |

        | `FILLED` | Fully filled. |

        | `CANCELLED` / `REJECTED` | Terminal. |
      example: OPEN

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.