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

# List my orders

> Returns the authenticated user's orders (resting and filled). The account is taken from the SIWE session — do not pass `account`. Unlike public `GET /orders?conditionId=…`, this includes `open` quotes. Strict pagination: invalid `limit` / `offset` return 400 (max `limit` 200).



## OpenAPI

````yaml /api-spec/openapi.yaml get /me/orders
openapi: 3.0.3
info:
  title: United Market API
  version: 1.0.0
  description: >-
    Public backend API for market data, trading, authentication, profiles,
    comments, and leaderboards.
servers:
  - url: https://api.unitedmarket.ai
    description: United Market backend
security: []
tags:
  - name: Markets
    description: >-
      Market discovery, market details, orderbooks, tickers, price history, and
      trades.
  - name: Orders
    description: Signed order submission, cancellation, order lookup, and balances.
  - name: Authentication
    description: SIWE wallet authentication.
  - name: Discovery
    description: Tags and market groups.
  - name: Social
    description: Comments, users, and leaderboard data.
  - name: Fees
    description: Effective trading fee rate per market.
  - name: Referral
    description: Referral codes, attribution, and reward summaries.
  - name: Sports
    description: Live and recently finished sports scores.
paths:
  /me/orders:
    get:
      tags:
        - Orders
      summary: List my orders
      description: >-
        Returns the authenticated user's orders (resting and filled). The
        account is taken from the SIWE session — do not pass `account`. Unlike
        public `GET /orders?conditionId=…`, this includes `open` quotes. Strict
        pagination: invalid `limit` / `offset` return 400 (max `limit` 200).
      operationId: listMyOrders
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 200
            default: 50
          description: Page size. Invalid values return 400 (not clamped).
        - name: offset
          in: query
          schema:
            type: integer
            minimum: 0
            maximum: 100000
            default: 0
          description: Number of items to skip. Invalid values return 400.
      responses:
        '200':
          description: Orders returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrderList'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      security:
        - bearerAuth: []
components:
  schemas:
    OrderList:
      type: object
      properties:
        orders:
          type: array
          items:
            $ref: '#/components/schemas/Order'
    Order:
      type: object
      additionalProperties: true
      properties:
        orderHash:
          type: string
        account:
          type: string
        conditionId:
          type: string
        tokenId:
          type: string
        status:
          type: string
          enum:
            - open
            - partially_filled
            - filled
            - cancelled_local
            - cancelled_onchain
            - expired
            - pending_settlement
          description: >-
            `open` / `partially_filled` rest on the book. `pending_settlement`
            matched but not yet on-chain. `cancelled_local` is an API/matcher
            cancel (including FOK/POST_ONLY that never rested).
            `cancelled_onchain` was cancelled in a settlement tx. `expired`
            missed its expiration.
    Error:
      type: object
      properties:
        message:
          type: string
          description: >-
            Human-readable error. Nested arrays are possible for validation
            errors.
        error:
          type: string
          description: >-
            Nest HTTP exception name (`Unauthorized`, `Bad Request`, `Not
            Found`). Present on most errors; a few handwritten responses omit it
            and only return `{ statusCode, message }`.
          example: Unauthorized
        statusCode:
          type: integer
          example: 401
  responses:
    BadRequest:
      description: Invalid request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: >-
        Missing or unknown `x-api-key`, or missing SIWE bearer on a protected
        route. Nest's default body includes `error`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Invalid API Key provided
            error: Unauthorized
            statusCode: 401
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: SIWE access token returned by POST /auth/verify.

````