> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rails.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Open Orders

> Retrieve your resting orders.



## OpenAPI

````yaml GET /v1/matching/orders/open
openapi: 3.1.0
info:
  title: Options Matching API
  version: 1.0.0
  description: >-
    Order management endpoints for Rails Options. Base URLs vary by environment
    — see the Environments page. Authorize with the access token obtained from
    the Auth API.
servers:
  - url: https://api-options.sandbox.rails.xyz
security:
  - bearerAuth: []
paths:
  /v1/matching/orders/open:
    get:
      summary: Get Open Orders
      description: Returns your resting orders across every contract, newest first.
      operationId: getOptionsOpenOrders
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenOrders'
              example:
                orders:
                  - orderId: 01JRQM8H5XYZABCDEFGHJKMNPQ
                    market: BTC-7FEB26-100000-C
                    side: buy
                    type: limit
                    price: '1250.5'
                    quantity: '2'
                    filledQuantity: '1'
                    avgFillPrice: '1249'
                    leverage: '0'
                    reduceOnly: false
                    postOnly: false
                    createdAt: 1770000000000
                    updatedAt: 1770000001500
                    status: open
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '502':
          $ref: '#/components/responses/MatchingUnavailable'
        '504':
          $ref: '#/components/responses/MatchingTimeout'
components:
  schemas:
    OpenOrders:
      type: object
      properties:
        orders:
          type: array
          description: Resting orders; empty when you have none.
          items:
            $ref: '#/components/schemas/OpenOrder'
      required:
        - orders
    OpenOrder:
      type: object
      properties:
        orderId:
          type: string
          description: Unique identifier for the order.
        market:
          type: string
          description: Contract name.
        side:
          type: string
          description: Order side.
          enum:
            - buy
            - sell
        type:
          type: string
          description: Order type.
          enum:
            - limit
            - market
        price:
          type: string
          description: Order price.
        quantity:
          type: string
          description: Order quantity.
        filledQuantity:
          type: string
          description: Quantity filled so far.
        avgFillPrice:
          type: string
          description: Volume-weighted average fill price; `0` while nothing has filled.
        leverage:
          type: string
          description: Leverage — always `0` for options.
        reduceOnly:
          type: boolean
          description: Reduce-only flag.
        postOnly:
          type: boolean
          description: Maker-only flag.
        createdAt:
          type: integer
          format: int64
          description: Order creation timestamp (milliseconds since epoch).
        updatedAt:
          type: integer
          format: int64
          description: Order last update timestamp (milliseconds since epoch).
        status:
          type: string
          description: Always `open`.
      required:
        - orderId
        - market
        - side
        - type
        - price
        - quantity
        - filledQuantity
        - avgFillPrice
        - leverage
        - reduceOnly
        - postOnly
        - createdAt
        - updatedAt
        - status
    Error:
      type: object
      properties:
        error:
          type: string
          description: A human-readable message describing the error.
      required:
        - error
  responses:
    Unauthorized:
      description: ''
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: unauthorized
    RateLimited:
      description: ''
      headers:
        Retry-After:
          description: >-
            Number of seconds to wait before making another request (429
            responses only).
          required: true
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: api rate limit exceeded
    MatchingUnavailable:
      description: ''
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: matching service unavailable
    MatchingTimeout:
      description: ''
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: matching service timed out
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````