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

# Get your lead trader profile

> Get your lead trader profile.

 Your profile, follow summary and stats for every window. 404 when you
 are not a lead trader.



## OpenAPI

````yaml /proto-openapi/api/openapi.yaml get /api/v1/copy-trading/leaders/me
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/copy-trading/leaders/me:
    get:
      tags:
        - CopyTradingService
        - Copy Trading
      summary: Get your lead trader profile
      description: |-
        Get your lead trader profile.

         Your profile, follow summary and stats for every window. 404 when you
         are not a lead trader.
      operationId: get_my_lead_trader
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetLeadTraderResponse'
        '401':
          description: Authentication required
        '404':
          description: You are not a lead trader
        '429':
          description: >-
            Read rate limit exceeded — every authenticated read draws one
            request from the account's read budget; retry after the interval in
            details.retryAfter
        '500':
          description: Internal server error
      security:
        - monacoSignature: []
        - monacoHttpSignature: []
components:
  schemas:
    GetLeadTraderResponse:
      type: object
      properties:
        profile:
          allOf:
            - $ref: '#/components/schemas/LeadTraderProfile'
          description: The leader's profile.
          nullable: true
        followSummary:
          allOf:
            - $ref: '#/components/schemas/LeadTraderFollowSummary'
          description: Current followers and allocation.
          nullable: true
        stats:
          type: array
          items:
            $ref: '#/components/schemas/LeadTraderStats'
          description: Stats for 7d, 30d, 90d and all, in that order.
          nullable: true
    LeadTraderProfile:
      type: object
      properties:
        leader:
          allOf:
            - $ref: '#/components/schemas/LeadTraderRef'
          description: Who the leader is.
          nullable: true
        status:
          example: ACTIVE
          type: string
          description: >-
            ACTIVE (accepting follows), PAUSED (existing follows keep mirroring,
            no new follows) or SUSPENDED (only on your own profile)
          nullable: true
        shareBps:
          example: 1000
          type: integer
          description: The leader's share of followers' realized profit, in basis points
          format: uint32
          nullable: true
        bio:
          type: string
          description: Free-text profile description; empty when none
          nullable: true
        minAllocation:
          example: '1000'
          type: string
          description: >-
            The leader's minimum follow allocation in quote units, when above
            the platform floor
          nullable: true
        registeredAt:
          example: '2026-09-23T12:00:00Z'
          type: string
          description: Registration time (RFC 3339)
          nullable: true
    LeadTraderFollowSummary:
      type: object
      properties:
        followerCount:
          example: 12
          type: integer
          description: Live follows (ACTIVE or CLOSE_ONLY)
          format: uint32
          nullable: true
        allocated:
          example: '25000'
          type: string
          description: >-
            Collateral allocated by live follows, in quote units (AUM as
            allocated, not marked)
          nullable: true
        aumEquity:
          example: '25400.5'
          type: string
          description: >-
            Equity of live follows' copy accounts at the engine's marks, in
            quote units (AUM marked: collateral plus unrealized PnL of copy
            positions). Absent when it could not be read. Not trading PnL
          nullable: true
      description: Current followers and the collateral they have allocated. Window-free.
    LeadTraderStats:
      type: object
      properties:
        window:
          example: 30d
          type: string
          description: 7d, 30d, 90d or all
          nullable: true
        pnl:
          example: '1250.5'
          type: string
          description: >-
            Trading PnL over the window in quote units: realized plus
            unrealized, net of fees and funding
          nullable: true
        roiPct:
          example: '12.5'
          type: string
          description: >-
            PnL as a percentage of the highest base balance (starting equity
            plus net deposits) over the window; absent when that base is not
            positive
          nullable: true
        maxDrawdownPct:
          example: '4.2'
          type: string
          description: >-
            Largest peak-to-trough fall of cumulative PnL over the window, as a
            percentage of the highest base balance; sampled at the window's
            rollup interval (1h for 7d, 4h for 30d and 90d, 1d for all)
          nullable: true
        winRatePct:
          example: '61.5'
          type: string
          description: >-
            Winning closes as a percentage of winning plus losing closes over
            the window; absent when there were none
          nullable: true
        closedTrades:
          example: 40
          type: integer
          description: Closes over the window, break-even included
          format: uint32
          nullable: true
      description: |-
        A leader's trading performance over one window, from the account PnL
         rollups. Bucket balances never feed these numbers.
    LeadTraderRef:
      type: object
      properties:
        walletAddress:
          example: '0x1234567890abcdef1234567890abcdef12345678'
          type: string
          description: The leader's wallet address (lowercase hex)
          nullable: true
          pattern: ^0x[0-9a-fA-F]{40}$
          minLength: 42
          maxLength: 42
        handle:
          example: alpha_trader
          type: string
          description: The leader's custom TraderCode handle, when claimed
          nullable: true
        display:
          example: alpha_trader
          type: string
          description: >-
            The handle when claimed, else the wallet address (every listed or
            addressable leader has a handle)
          nullable: true
      description: 'A lead trader as the public sees them: never an internal id.'
  securitySchemes:
    monacoSignature:
      type: apiKey
      description: >-
        Ed25519 session-key request signing. Every authenticated request carries
        three headers: `X-Monaco-PublicKey` (64-char lowercase-hex session
        public key), `X-Monaco-Timestamp` (Unix milliseconds, within 30s of
        server time), and `X-Monaco-Signature` (hex ed25519 signature). The
        signature is over `METHOD\npath?query\ntimestamp_ms\nSHA256_hex(body)`,
        where the body hash is the SHA-256 of the empty byte string when there
        is no body. Obtain the session keypair from `POST
        /api/v1/auth/challenge` followed by `POST /api/v1/auth/verify`.
      name: X-Monaco-Signature
      in: header
    monacoHttpSignature:
      type: apiKey
      description: >-
        RFC 9421 Ed25519 session-key request signatures. Send Signature-Input,
        Signature, and Content-Digest together; never combine them with
        X-Monaco-* credentials. The monaco signature covers @method, @path,
        @query, and content-digest in that order, with created (Unix seconds
        within 30s of server time), keyid (registered lowercase-hex session
        public key), and alg=ed25519 parameters. Content-Digest uses RFC 9530
        sha-256 over the exact body bytes, including the empty body. Query
        coverage retains ordering and percent encoding. Timestamp freshness does
        not reject repeated identical requests; use endpoint idempotency where
        supported. Existing legacy signing remains supported during server-first
        migration; SDK RFC 9421 signing is opt-in. See
        https://docs.0xmonaco.com/reference/http-message-signatures for the
        complete profile and trust model.
      name: Signature
      in: header

````