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

> Wallets ranked by all-time taker volume, largest first. One row per
 wallet, every builder counted.



## OpenAPI

````yaml /proto-openapi/api/openapi.yaml get /api/v1/analytics/wallet-leaderboard
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/wallet-leaderboard:
    get:
      tags:
        - AnalyticsService
        - Analytics
      summary: Wallet leaderboard
      description: |-
        Wallets ranked by all-time taker volume, largest first. One row per
         wallet, every builder counted.
      operationId: list_wallet_leaderboard
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            format: uint32
            minimum: 1
            maximum: 100
            default: 25
          description: Wallets to return, largest volume first (max 100)
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListWalletLeaderboardResponse'
        '400':
          description: Invalid limit
        '429':
          description: Public read rate limit exceeded for this client
        '500':
          description: Internal server error
components:
  schemas:
    ListWalletLeaderboardResponse:
      type: object
      properties:
        wallets:
          type: array
          items:
            $ref: '#/components/schemas/WalletVolume'
          description: >-
            Wallets by all-time volume, largest first (ties by wallet), up to
            limit.
          nullable: true
    WalletVolume:
      type: object
      properties:
        wallet:
          example: '0x1234567890abcdef1234567890abcdef12345678'
          type: string
          description: Wallet address, lowercase
          nullable: true
        volumeUsd:
          example: '125000.5'
          type: string
          description: All-time taker volume in USD (USDC 1:1)
          nullable: true
        tradesCount:
          example: 412
          type: integer
          description: Trades the wallet took
          format: int64
          minimum: 0
          nullable: true
        firstTradedAt:
          example: 1758000000000
          type: integer
          description: The wallet's first taker trade as Unix milliseconds
          format: int64
          minimum: 0
          nullable: true
        lastTradedAt:
          example: 1762041600000
          type: integer
          description: The wallet's latest taker trade as Unix milliseconds
          format: int64
          minimum: 0
          nullable: true
      description: One wallet's all-time taker figures, every builder included

````

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