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

# Get Order

> Fetches a Kalshi order by its issued order id.



## OpenAPI

````yaml /openapi/v1.json get /v1/kalshi/orders/{orderId}
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/{orderId}:
    get:
      tags:
        - Kalshi
      summary: Get Order
      description: Fetches a Kalshi order by its issued order id.
      operationId: getKalshiOrder
      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
            format: uuid
            description: Issued order id.
            example: 3f8b2c9a-2d18-4f7e-9c2a-1b6e1f0c8a4d
          required: true
          name: orderId
          in: path
      responses:
        '200':
          description: Order found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KalshiOrderView'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: Order not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    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
    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
    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
    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.

````