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

# Wallet trades

> Every fill one wallet was in, as maker or taker, newest first, every
 market and application. No fee is published.



## OpenAPI

````yaml /proto-openapi/api/openapi.yaml get /api/v1/analytics/wallets/{wallet}/trades
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://apimonaco.xyz
    description: Production (Sei mainnet)
security: []
tags:
  - name: AccountsService
  - name: AnalyticsService
  - name: ApplicationsService
  - name: AuthService
  - name: BuildercodeRewardsService
  - name: ComplianceService
  - 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: RfqService
  - name: SweeperService
  - name: TraderCodeService
  - name: TradesService
  - name: WithdrawalsService
paths:
  /api/v1/analytics/wallets/{wallet}/trades:
    get:
      tags:
        - AnalyticsService
        - Analytics
      summary: Wallet trades
      description: |-
        Every fill one wallet was in, as maker or taker, newest first, every
         market and application. No fee is published.
      operationId: list_wallet_trades
      parameters:
        - name: wallet
          in: path
          required: true
          schema:
            type: string
        - name: pageSize
          in: query
          schema:
            type: integer
            format: uint32
            minimum: 1
            maximum: 1000
            default: 50
          description: Fills per page (max 1000)
        - name: pageToken
          in: query
          description: >-
            Opaque keyset cursor from the previous response, bound to the
            wallet.
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListWalletTradesResponse'
        '400':
          description: Invalid wallet address, page size or page token
        '429':
          description: Public read rate limit exceeded for this client
        '500':
          description: Internal server error
components:
  schemas:
    ListWalletTradesResponse:
      type: object
      properties:
        trades:
          type: array
          items:
            $ref: '#/components/schemas/WalletTrade'
          description: >-
            The wallet's fills in reverse chronological order (ties by trade
            id).
          nullable: true
        pageSize:
          example: 50
          type: integer
          description: Number of fills requested for this page
          format: uint32
          nullable: true
        nextPageToken:
          type: string
          description: >-
            Opaque cursor for the next page; empty when the page is the end of
            the ordered result
          nullable: true
    WalletTrade:
      type: object
      properties:
        id:
          example: 0f3c1f9e-5f43-4d57-9f71-2c1a3b4d5e6f
          type: string
          description: Trade UUID
          format: uuid
          nullable: true
        executedAt:
          example: 1762041600000
          type: integer
          description: When the fill executed, as Unix milliseconds
          format: int64
          minimum: 0
          nullable: true
        tradingPairId:
          example: 123e4567-e89b-12d3-a456-426614174000
          type: string
          description: Trading pair UUID
          format: uuid
          nullable: true
        tradingMode:
          example: MARGIN
          enum:
            - SPOT
            - MARGIN
          type: string
          description: SPOT or MARGIN
          nullable: true
        role:
          example: TAKER
          enum:
            - MAKER
            - TAKER
          type: string
          description: The wallet's role on the fill
          nullable: true
        side:
          example: BUY
          enum:
            - BUY
            - SELL
          type: string
          description: >-
            The wallet's side: the maker's side when it made the fill, the
            opposite when it took it
          nullable: true
        price:
          example: '100.5'
          type: string
          description: Execution price in quote per base unit
          nullable: true
        quantity:
          example: '0.25'
          type: string
          description: Quantity in base units, normalized by the base asset's decimals
          nullable: true
        quantityRaw:
          example: '250000000000000000'
          type: string
          description: Quantity in raw base token units
          nullable: true
        quoteVolumeRaw:
          example: '25125000'
          type: string
          description: Notional in raw quote token units; null on a fill that recorded none
          nullable: true
        executionSource:
          example: CLOB
          enum:
            - CLOB
            - RFQ
          type: string
          description: 'CLOB: the order book. RFQ: an RFQ block fill.'
          nullable: true
        counterparty:
          example: '0xabcdefabcdefabcdefabcdefabcdefabcdefabcd'
          type: string
          description: >-
            The other side's wallet, lowercase (the wallet itself on a
            self-cross)
          nullable: true
        builder:
          allOf:
            - $ref: '#/components/schemas/Builder'
          description: >-
            The displayed builder of the wallet's side of the fill; null when
            that
             builder is hidden or the fill names none. applications is empty.
          nullable: true
      description: >-
        One fill of the wallet, from the wallet's side. A fill the wallet was on
        both sides of is one row with role MAKER. Amounts follow the public
        trade feed: price in quote per base unit, quantity normalized,
        quantityRaw and quoteVolumeRaw in raw token units.
    Builder:
      type: object
      properties:
        id:
          example: 789e0123-e45b-12d3-a456-426614174000
          type: string
          description: Application UUID, or display group UUID when kind is group
          format: uuid
          nullable: true
        kind:
          example: application
          enum:
            - application
            - group
          type: string
          description: >-
            application: one application. group: a display group of several
            applications shown as one builder.
          nullable: true
        name:
          example: Monaco SDK
          type: string
          description: Display name
          nullable: true
        code:
          example: MON
          type: string
          description: Short display code, if set; also a lookup key
          nullable: true
        color:
          example: '#112233'
          type: string
          description: 'Display color, #rrggbb or #rrggbbaa, if set'
          nullable: true
        verified:
          example: true
          type: boolean
          description: Shown as verified
          nullable: true
        group:
          allOf:
            - $ref: '#/components/schemas/BuilderGroupRef'
          description: >-
            The display group an application is shown under on the directory and
            the
             leaderboard, when it has one. Unset for a group and for an ungrouped
             application.
          nullable: true
        applications:
          type: array
          items:
            $ref: '#/components/schemas/BuilderApplication'
          description: |-
            The application itself (kind application), or the group's displayed
             applications (kind group). Builder attribution on other responses (wallet
             summaries, deposit and withdrawal feeds) may send this empty: there the
             builder is an identity only.
          nullable: true
      description: >-
        A builder's identity: an application, or a display group of
        applications.
    BuilderGroupRef:
      type: object
      properties:
        id:
          example: 5b1e2c9a-0f6d-4e8b-9a71-3c2d4e5f6a7b
          type: string
          description: >-
            Display group UUID; GET /api/v1/analytics/builders/{id} answers the
            group
          format: uuid
          nullable: true
        name:
          example: Monaco
          type: string
          description: The group's display name
          nullable: true
        code:
          example: MON
          type: string
          description: The group's display code, if it has one
          nullable: true
      description: A group's identity, for an application shown under a display group.
    BuilderApplication:
      type: object
      properties:
        id:
          example: 789e0123-e45b-12d3-a456-426614174000
          type: string
          description: Application UUID
          format: uuid
          nullable: true
        name:
          example: Monaco SDK
          type: string
          description: Application name
          nullable: true
        clientId:
          example: 6fe0da813f1a4adcbe675d52ca530a43
          type: string
          description: On-chain client id the application's deposits carry
          nullable: true
        active:
          example: true
          type: boolean
          description: >-
            Whether the application can place new orders. An inactive builder
            keeps the volume it routed.
          nullable: true
        archived:
          example: false
          type: boolean
          description: >-
            Whether the application is archived. Archived applications are left
            out of the builder directory but keep their figures.
          nullable: true
        additionalTakerFeeBps:
          example: 0
          type: integer
          description: >-
            Taker add-on the application charges, in basis points:
            `additionalTakerFeeCbps` truncated to whole bps
          format: int32
          nullable: true
        additionalMakerFeeBps:
          example: 0
          type: integer
          description: >-
            Maker add-on the application charges, in basis points:
            `additionalMakerFeeCbps` truncated to whole bps
          format: int32
          nullable: true
        isDefault:
          example: false
          type: boolean
          description: >-
            Whether this is the exchange's default application: the one a
            sign-in that names no client id is placed under
          nullable: true
        additionalTakerFeeCbps:
          example: 0
          type: integer
          description: >-
            Taker add-on the application charges by default, in centi-bps (1 bps
            = 100 cbps); authoritative. The `additionalTakerFeeBps` field is the
            same rate truncated to whole bps.
          format: int32
          nullable: true
        additionalMakerFeeCbps:
          example: 0
          type: integer
          description: >-
            Maker add-on the application charges by default, in centi-bps (1 bps
            = 100 cbps); authoritative. The `additionalMakerFeeBps` field is the
            same rate truncated to whole bps.
          format: int32
          nullable: true
      description: One application behind a builder.

````

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