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

# List application orders

> List application orders.

 Returns a paginated list of all orders placed by the application's users.
 Public: the application is selected by `client_id`.



## OpenAPI

````yaml /proto-openapi/api/openapi.yaml get /api/v1/applications/orders
openapi: 3.0.3
info:
  title: Monaco Protocol API
  description: REST API for the Monaco Protocol hybrid CLOB exchange.
  version: 1.0.0
servers:
  - url: https://staging.apimonaco.xyz
    description: Staging server (Testnet)
security: []
tags:
  - name: AccountsService
  - name: ApplicationsService
  - name: AuthService
  - name: BuildercodeRewardsService
  - name: CopyTradingService
  - name: DelegatedAgentsService
  - name: FaucetService
  - name: FeesService
  - name: HealthService
  - name: ManagedMarketsService
    description: |-
      Wallet-authenticated maker assignments. The signed session must match both
       configured maker user and application. Owner IDs are process fences, never auth.
       Only wallet sessions are supported; delegated-agent sessions receive 403.
  - name: MarginAccountsService
    description: |-
      Current public isolated-margin semantics:
       - a user has one parent margin account per application scope
       - opening orders create or reuse isolated position buckets under that parent
       - parent account creation is handled internally by margin workflows
  - name: MarketService
  - name: OrderbookService
  - name: OrdersService
  - name: PositionsService
    description: |-
      Current public isolated-margin semantics:
       - positions link to a parent margin account and, when applicable, a bucket id
       - opening orders create or reuse isolated position buckets under the parent
       - users can open another isolated position by reusing the parent account with a different market bucket
  - name: PulseService
  - name: SweeperService
  - name: TraderCodeService
  - name: TradesService
  - name: WhitelistService
  - name: WithdrawalsService
paths:
  /api/v1/applications/orders:
    get:
      tags:
        - ApplicationsService
        - Applications
      summary: List application orders
      description: |-
        List application orders.

         Returns a paginated list of all orders placed by the application's users.
         Public: the application is selected by `client_id`.
      operationId: list_application_orders
      parameters:
        - name: pageSize
          in: query
          schema:
            type: integer
            format: uint32
            minimum: 1
            maximum: 1000
            default: 20
          description: Items per page (max 1000)
        - name: status
          in: query
          schema:
            type: string
            minLength: 1
          description: Order status (single value or comma-separated list)
        - name: userId
          in: query
          schema:
            type: string
            minLength: 1
            format: uuid
          description: User identifier (UUID)
        - name: tradingPairId
          in: query
          schema:
            type: string
            minLength: 1
            format: uuid
          description: Trading pair identifier (UUID)
        - name: side
          in: query
          schema:
            type: string
            enum:
              - BUY
              - SELL
            minLength: 1
          description: Order side
        - name: orderType
          in: query
          schema:
            type: string
            enum:
              - LIMIT
              - MARKET
              - STOP_LOSS
              - TAKE_PROFIT
              - STOP_LIMIT
              - TRAILING_STOP
            minLength: 1
          description: Order type
        - name: pageToken
          in: query
          description: |-
            Pagination cursor with two states:
              - Omitted or empty string (""): start a cursor walk with no prior
                position.
              - Non-empty: an opaque cursor from a previous response's
                `nextPageToken`; results resume immediately after that position.

             Every walk covers full order history — hot and archived rows merged.
             The response carries no item count: `orders_all` is too large to count
             behind a filter.

             Filters must match the request that produced the token, or the request
             is rejected 400.
          schema:
            type: string
        - name: clientId
          in: query
          description: Application client ID
          schema:
            type: string
            minLength: 1
          required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAppOrdersResponse'
        '400':
          description: Bad request (missing client_id, invalid filter or page token)
        '404':
          description: No active application has this client_id
        '429':
          description: >-
            Public read rate limit exceeded for this client IP; retry after the
            interval in details.retryAfter
        '500':
          description: Internal server error
components:
  schemas:
    ListAppOrdersResponse:
      type: object
      properties:
        orders:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationOrder'
          nullable: true
        pageSize:
          example: 20
          type: integer
          description: Items per page
          format: uint32
          nullable: true
        nextPageToken:
          type: string
          description: >-
            Cursor for the next page, minted from the last row of an
            over-fetched
             page: this listing is one ordered read, so a page shorter than
             `pageSize` proves the walk is exhausted and this is empty.
          nullable: true
    ApplicationOrder:
      type: object
      properties:
        id:
          example: 123e4567-e89b-12d3-a456-426614174000
          type: string
          description: Order UUID
          format: uuid
          nullable: true
        userId:
          example: 123e4567-e89b-12d3-a456-426614174000
          type: string
          description: User UUID who placed the order
          format: uuid
          nullable: true
        tradingPairId:
          example: 456e7890-e12b-12d3-a456-426614174000
          type: string
          description: Trading pair UUID
          format: uuid
          nullable: true
        orderType:
          example: LIMIT
          type: string
          description: >-
            Order type: LIMIT, MARKET, STOP_LOSS, TAKE_PROFIT, STOP_LIMIT, or
            TRAILING_STOP
          nullable: true
        side:
          example: BUY
          type: string
          description: 'Order side: BUY or SELL'
          nullable: true
        price:
          example: '35000.00'
          type: string
          description: Order price (null for market orders)
          nullable: true
        quantity:
          example: '0.5'
          type: string
          description: Order quantity (normalized for display)
          nullable: true
        quantityRaw:
          example: '500000000'
          type: string
          description: Order quantity in raw format (for precision)
          nullable: true
        filledQuantity:
          example: '0.2'
          type: string
          description: Filled quantity (normalized for display)
          nullable: true
        filledQuantityRaw:
          example: '200000000'
          type: string
          description: Filled quantity in raw format
          nullable: true
        averageFillPrice:
          example: '35050.00'
          type: string
          description: Volume-weighted average fill price
          nullable: true
        status:
          example: SUBMITTED
          type: string
          description: Order status
          nullable: true
        tradingMode:
          example: SPOT
          type: string
          description: 'Trading mode: SPOT or MARGIN'
          nullable: true
        timeInForce:
          example: GTC
          type: string
          description: 'Time in force: GTC, IOC, or FOK'
          nullable: true
        createdAt:
          example: '2023-11-13T10:30:00Z'
          type: string
          description: Order creation timestamp (ISO 8601)
          nullable: true
        updatedAt:
          example: '2023-11-13T10:35:00Z'
          type: string
          description: Order last update timestamp (ISO 8601)
          nullable: true

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.