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

> List application movements.

 Returns a paginated list of the ledger movements (deposits, withdrawals,
 trades, etc.) of the application's users. Public: the application is
 selected by `client_id`.



## OpenAPI

````yaml /proto-openapi/api/openapi.yaml get /api/v1/applications/movements
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/movements:
    get:
      tags:
        - ApplicationsService
        - Applications
      summary: List application movements
      description: |-
        List application movements.

         Returns a paginated list of the ledger movements (deposits, withdrawals,
         trades, etc.) of the application's users. Public: the application is
         selected by `client_id`.
      operationId: list_application_movements
      parameters:
        - name: pageSize
          in: query
          schema:
            type: integer
            format: uint32
            minimum: 1
            maximum: 1000
            default: 20
          description: Items per page (max 1000)
        - name: userId
          in: query
          schema:
            type: string
            minLength: 1
            format: uuid
          description: User identifier (UUID)
        - name: transactionType
          in: query
          schema:
            type: string
            enum:
              - DEPOSIT
              - WITHDRAWAL
              - TRADE
              - FEE
              - FUNDING
              - LIQUIDATION
              - INTEREST
              - REWARD
              - CHAIN_SYNC
            minLength: 1
          description: Transaction type
        - name: entryType
          in: query
          schema:
            type: string
            enum:
              - CREDIT
              - DEBIT
              - LOCK
              - UNLOCK
              - FEE
            minLength: 1
          description: Ledger entry type
        - name: assetId
          in: query
          schema:
            type: string
            minLength: 1
            format: uuid
          description: Asset identifier (UUID)
        - name: pageToken
          in: query
          description: |-
            Pagination cursor with two states:
              - Omitted or empty string (""): start a cursor walk with no prior
                position, from the newest movement.
              - Non-empty: an opaque cursor from a previous response's
                `nextPageToken`; results resume immediately after that position.

             The response carries no item count: `user_ledger` is too large to count
             behind a filter. A movement with no recorded timestamp is not listed —
             the column is nullable, and a NULL has no position in the sort key.

             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/ListAppMovementsResponse'
        '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:
    ListAppMovementsResponse:
      type: object
      properties:
        movements:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationMovement'
          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
    ApplicationMovement:
      type: object
      properties:
        amount:
          type: string
          description: Transaction amount
          nullable: true
        balanceAfter:
          type: string
          description: Balance after this transaction
          nullable: true
        balanceBefore:
          type: string
          description: Balance before this transaction
          nullable: true
        balanceId:
          type: string
          description: Balance UUID this movement affects
          format: uuid
          nullable: true
        blockNumber:
          type: string
          description: Blockchain block number
          nullable: true
        createdAt:
          type: string
          description: Transaction timestamp (ISO 8601)
          nullable: true
        description:
          type: string
          description: Human readable description
          nullable: true
        entryType:
          type: string
          description: Type of ledger entry
          nullable: true
        id:
          type: string
          description: Movement UUID
          format: uuid
          nullable: true
        lockedAfter:
          type: string
          description: Locked balance after transaction
          nullable: true
        lockedBefore:
          type: string
          description: Locked balance before transaction
          nullable: true
        referenceId:
          type: string
          description: Reference identifier for related operations
          format: uuid
          nullable: true
        referenceType:
          type: string
          description: Reference type
          nullable: true
        token:
          type: string
          description: Token address
          nullable: true
        transactionType:
          type: string
          description: Type of transaction
          nullable: true
        txHash:
          type: string
          description: Blockchain transaction hash
          nullable: true
        userId:
          type: string
          description: User UUID who owns this movement
          format: uuid
          nullable: true

````

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