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

> One wallet's cumulative realized PnL, over every application it trades
 under: realized perps and spot PnL and funding, net of every fee the
 wallet was charged. All time, with a daily cumulative series. No fee
 figure is published.



## OpenAPI

````yaml /proto-openapi/api/openapi.yaml get /api/v1/analytics/wallets/{wallet}/pnl
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}/pnl:
    get:
      tags:
        - AnalyticsService
        - Analytics
      summary: Wallet PnL
      description: |-
        One wallet's cumulative realized PnL, over every application it trades
         under: realized perps and spot PnL and funding, net of every fee the
         wallet was charged. All time, with a daily cumulative series. No fee
         figure is published.
      operationId: get_wallet_pnl
      parameters:
        - name: wallet
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetWalletPnlResponse'
        '400':
          description: Invalid wallet address
        '429':
          description: Public read rate limit exceeded for this client
        '500':
          description: Internal server error
components:
  schemas:
    GetWalletPnlResponse:
      type: object
      properties:
        wallet:
          example: '0x1234567890abcdef1234567890abcdef12345678'
          type: string
          description: The wallet, lowercase
          nullable: true
        totals:
          allOf:
            - $ref: '#/components/schemas/WalletPnlTotals'
          description: >-
            Cumulative realized PnL since historyStartsAt, summed over the
            wallet's
             applications; null when there is no PnL history for the wallet (coverage
             none), never zero for an unknown.
          nullable: true
        historyStartsAt:
          example: 1760486400000
          type: integer
          description: >-
            Where the wallet's PnL history starts: the hour of its earliest
            sample, as Unix milliseconds; null with coverage none
          format: int64
          minimum: 0
          nullable: true
        dataThrough:
          example: 1762041600000
          type: integer
          description: >-
            The newest PnL sample the figures include, as Unix milliseconds;
            null with coverage none
          format: int64
          minimum: 0
          nullable: true
        coverage:
          example: complete
          enum:
            - none
            - partial
            - complete
          type: string
          description: >-
            none: no PnL history for the wallet (totals null, no points).
            partial: the wallet traded before its history starts (or traded
            under an application with no history), so totals and points leave
            that trading out and are not all-time. complete: the history covers
            every fill of the wallet, so totals are all-time.
          nullable: true
        bucketInterval:
          example: 1d
          enum:
            - 1d
          type: string
          description: Width of each point's bucket
          nullable: true
        points:
          type: array
          items:
            $ref: '#/components/schemas/WalletPnlPoint'
          description: >-
            One point per UTC day from the day historyStartsAt falls in through
            the
             current day, oldest first; empty with coverage none.
          nullable: true
    WalletPnlTotals:
      type: object
      properties:
        realizedPnl:
          example: '1250.5'
          type: string
          description: >-
            Realized perps PnL plus realized spot trading PnL, net of every fee
            the wallet was charged (exchange taker and maker fees, maker rebates
            counting as negative fees, and builder add-ons)
          nullable: true
        fundingPnl:
          example: '-12.25'
          type: string
          description: >-
            Funding received less funding paid; positive when the wallet
            received more than it paid
          nullable: true
        netPnl:
          example: '1238.25'
          type: string
          description: realizedPnl + fundingPnl
          nullable: true
      description: >-
        A wallet's cumulative realized PnL in USD (USDC 1:1) since
        historyStartsAt. netPnl = realizedPnl + fundingPnl. Fees are inside
        realizedPnl and are not published apart.
    WalletPnlPoint:
      type: object
      properties:
        bucketStart:
          example: 1760486400000
          type: integer
          description: Start of the UTC day as Unix milliseconds
          format: int64
          minimum: 0
          nullable: true
        realizedPnl:
          example: '1250.5'
          type: string
          description: Cumulative realized PnL net of fees, as WalletPnlTotals.realizedPnl
          nullable: true
        fundingPnl:
          example: '-12.25'
          type: string
          description: Cumulative funding received less paid
          nullable: true
        netPnl:
          example: '1238.25'
          type: string
          description: Cumulative realizedPnl + fundingPnl
          nullable: true
      description: >-
        The wallet's cumulative realized PnL at the end of one UTC day (the
        latest state for the current day), from historyStartsAt

````

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