> ## 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 Kalshi orders.



## OpenAPI

````yaml /openapi/v1.json get /v1/kalshi/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.
paths:
  /v1/kalshi/orders:
    get:
      tags:
        - Kalshi
      summary: List Orders
      description: Returns a paginated list of Kalshi orders.
      operationId: listKalshiOrders
      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 Kalshi market ticker.
          required: false
          name: ticker
          in: query
        - schema:
            type: string
            enum:
              - PENDING
              - SUBMITTED
              - OPEN
              - FILLED
              - CANCELLED
              - REJECTED
            description: Filter to orders in a single lifecycle status.
          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/ListKalshiOrdersResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    ListKalshiOrdersResponse:
      type: object
      properties:
        orders:
          type: array
          items:
            $ref: '#/components/schemas/KalshiOrderView'
          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
    KalshiOrderView:
      type: object
      properties:
        orderId:
          type: string
          format: uuid
          description: Issued order id.
          example: 3f8b2c9a-2d18-4f7e-9c2a-1b6e1f0c8a4d
        ticker:
          type: string
          description: Kalshi market ticker the order trades.
          example: KXPRES-2028
        side:
          $ref: '#/components/schemas/KalshiSide'
        action:
          $ref: '#/components/schemas/KalshiAction'
        type:
          $ref: '#/components/schemas/KalshiOrderType'
        count:
          type: integer
          description: Order size in whole contracts.
          example: 10
        priceCents:
          type: integer
          description: >-
            Limit price in whole cents from 1 to 99, in the traded side's own
            frame.
          example: 38
        status:
          $ref: '#/components/schemas/TradingOrderStatus'
        venueOrderId:
          type: string
          nullable: true
          description: Kalshi order id, or null until the venue acknowledges the order.
          example: b4d9e1f2-3a6c-4d8e-9f1a-2b3c4d5e6f70
        createdAt:
          type: string
          description: Time the order was created, in ISO-8601.
          example: '2026-07-26T12:00:00.000Z'
        updatedAt:
          type: string
          description: Time the order was last updated, in ISO-8601.
          example: '2026-07-26T12:05:00.000Z'
        filledCount:
          type: integer
          nullable: true
          description: Contracts filled so far, or null before any fill.
          example: 4
        averagePriceCents:
          type: integer
          nullable: true
          description: Average fill price in whole cents, or null before any fill.
          example: 37
        feesCents:
          type: integer
          nullable: true
          description: >-
            Total fees charged, rounded to the nearest whole cent, or null
            before any fill.
          example: 6
        feesUsd:
          type: string
          nullable: true
          description: >-
            Total fees charged in dollars, exact to the granularity the venue
            charges, or null before any fill. Charged on top of the executed
            notional, so it is additive to cost on a buy and deducted from
            proceeds on a sell.
          example: '0.063000'
        closedAt:
          type: string
          nullable: true
          description: Time the order reached a terminal state, or null while still open.
          example: '2026-07-26T12:10:00.000Z'
      required:
        - orderId
        - ticker
        - side
        - action
        - type
        - count
        - priceCents
        - status
        - venueOrderId
        - createdAt
        - updatedAt
        - filledCount
        - averagePriceCents
        - feesCents
        - feesUsd
        - closedAt
    ApiErrorCode:
      type: string
      enum:
        - INVALID_REQUEST
        - NOT_FOUND
        - INSUFFICIENT_BALANCE
        - IDEMPOTENCY_CONFLICT
        - ORDER_NOT_CANCELLABLE
        - ORDER_RECONCILIATION_REQUIRED
        - INTERNAL_ERROR
      description: Stable identifier for the error category.
    KalshiSide:
      type: string
      enum:
        - 'YES'
        - 'NO'
      description: Which side of the Kalshi market the contract represents.
      example: 'YES'
    KalshiAction:
      type: string
      enum:
        - BUY
        - SELL
      description: Order direction against the chosen side.
      example: BUY
    KalshiOrderType:
      type: string
      enum:
        - LIMIT
      description: Order type. Kalshi orders are limit orders.
      example: LIMIT
    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` | Sent, awaiting venue acknowledgement. |
        | `OPEN` | Resting on the venue. |
        | `FILLED` | Fully filled. |
        | `CANCELLED` / `REJECTED` | Terminal. |
      example: OPEN

````