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

# Amend Order

> Reprices or resizes a resting Kalshi order in place.



## OpenAPI

````yaml /openapi/v1.json post /v1/kalshi/orders/{orderId}/amend
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/kalshi/orders/{orderId}/amend:
    post:
      tags:
        - Kalshi
      summary: Amend Order
      description: Reprices or resizes a resting Kalshi order in place.
      operationId: amendKalshiOrder
      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
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AmendKalshiOrderRequest'
      responses:
        '200':
          description: >-
            Order amended, or already resting on the terms asked for and
            returned unchanged
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AmendKalshiOrderResponse'
        '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'
        '404':
          description: Order not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '409':
          description: The order cannot be amended from its current state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '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: >-
            The venue's outcome for the amend is unknown; read the order before
            retrying
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ApiError'
                  - $ref: '#/components/schemas/AuthError'
components:
  schemas:
    AmendKalshiOrderRequest:
      type: object
      properties:
        price:
          type: string
          description: >-
            Limit price per contract in dollars, as a decimal string on the
            market's YES book. A price off that market's tick grid is rejected.
          example: '0.38'
        count:
          type: string
          description: >-
            The order's already filled count plus the resting count wanted after
            the amend.
          example: '10'
      required:
        - price
        - count
      additionalProperties: false
    AmendKalshiOrderResponse:
      type: object
      properties:
        order:
          $ref: '#/components/schemas/KalshiOrderView'
        previous:
          type: object
          properties:
            price:
              type: string
              description: >-
                Limit price per contract in dollars the order carried before the
                amend.
              example: '0.37'
            count:
              type: string
              description: Size in contracts the order carried before the amend.
              example: '8'
          required:
            - price
            - count
      required:
        - order
        - previous
    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
    KalshiOrderView:
      type: object
      properties:
        queuePosition:
          type: string
          nullable: true
          description: >-
            Contracts ahead of this order in price-time priority, or null when
            unavailable.
        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/KalshiOrderSide'
        type:
          $ref: '#/components/schemas/KalshiOrderType'
        count:
          type: string
          description: Order size in contracts, as a decimal string.
          example: '10'
        yesPrice:
          type: string
          nullable: true
          description: Limit price per YES contract in dollars, or null when unavailable.
        noPrice:
          type: string
          nullable: true
          description: >-
            Complementary limit price per NO contract in dollars, or null when
            unavailable.
        outcomeSide:
          $ref: '#/components/schemas/KalshiOutcomeSide'
        price:
          type: string
          nullable: true
          description: >-
            Deprecated; use yesPrice for the limit price per YES contract in
            dollars.
          example: '0.38'
          deprecated: true
        postOnly:
          type: boolean
          description: Whether the order was placed as maker-only.
          example: false
        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: string
          nullable: true
          description: >-
            Contracts filled so far as a decimal string, or null before any
            fill.
          example: '4'
        averageYesPrice:
          type: string
          nullable: true
          description: >-
            Fill-weighted average price per YES contract in dollars, or null
            before any fill.
        averageNoPrice:
          type: string
          nullable: true
          description: >-
            Complementary fill-weighted average price per NO contract in
            dollars, or null before any fill.
        averagePrice:
          type: string
          nullable: true
          description: >-
            Deprecated; use averageYesPrice for the fill-weighted average price
            per YES contract in dollars.
          example: '0.3725'
          deprecated: true
        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'
        clientOrderId:
          type: string
          description: >-
            Your own identifier for this order as you supplied it, otherwise its
            orderId.
          example: order-1
      required:
        - orderId
        - ticker
        - side
        - type
        - count
        - yesPrice
        - noPrice
        - outcomeSide
        - price
        - postOnly
        - status
        - venueOrderId
        - createdAt
        - updatedAt
        - filledCount
        - averageYesPrice
        - averageNoPrice
        - averagePrice
        - feesCents
        - feesUsd
        - closedAt
        - clientOrderId
    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.
    KalshiOrderSide:
      type: string
      enum:
        - BID
        - ASK
      description: |-
        Order direction on the market's YES book.

        | Side | Meaning |
        | --- | --- |
        | `BID` | Buy YES contracts, profiting if the market resolves YES. |
        | `ASK` | Sell YES contracts, profiting if the market resolves NO. |

        Selling YES is the same order as buying NO, so `ASK` covers both.
      example: BID
    KalshiOrderType:
      type: string
      enum:
        - LIMIT
      description: Order type. Kalshi orders are limit orders.
      example: LIMIT
    KalshiOutcomeSide:
      type: string
      enum:
        - 'YES'
        - 'NO'
      description: Economic direction of an order, YES for BID and NO for ASK.
      example: 'YES'
    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.