> ## Documentation Index
> Fetch the complete documentation index at: https://docs.limitless.exchange/llms.txt
> Use this file to discover all available pages before exploring further.

# Get My Referral Stats

> Your own referral standing: cumulative CLOB trading volume (the tier basis), total USDC earned from the referral program, and the active tier ladder. The current tier is not sent - resolve it as the highest ladder entry whose minBasisRaw your totalBasisRaw clears.

<Info>
  Money and volume fields are raw USDC with 6 decimals, returned as strings — divide by `1e6` for the dollar amount.
</Info>

Your current tier is not returned directly. Resolve it client-side as the highest `tiers` entry whose `minBasisRaw` your `totalBasisRaw` clears. When a `customTier` pin is present it acts as a floor: the effective tier is the higher of the pin and the volume-derived tier.

`totalEarnedRaw` is your accrued referral earnings. Earnings become payable once the underlying markets resolve and are then included in the daily payout — see the [Referral Program guide](/user-guide/referral-program).


## OpenAPI

````yaml GET /referral/usdc/me
openapi: 3.0.0
info:
  title: Limitless Exchange API
  description: >-
    Production-ready REST API for prediction market trading, portfolio
    management, and market data on Limitless Exchange (Base L2).
  version: '1.0'
  contact:
    name: API Support
    url: https://limitless.exchange
    email: help@limitless.network
servers:
  - url: https://api.limitless.exchange
    description: Production API
security: []
tags:
  - name: Authentication
    description: User authentication and session management
  - name: Markets
    description: Browse, search, and analyze prediction markets
  - name: Market Navigation
    description: Navigation tree, market pages, and property filters
  - name: Trading
    description: Create, manage, and cancel orders
  - name: Portfolio
    description: Position tracking, trade history, and performance
  - name: API Tokens
    description: Scoped API token management for partner integrations
  - name: Partner Accounts
    description: Sub-account creation and allowance recovery for partner integrations
  - name: System
    description: Public API state and availability information
  - name: Referral
    description: Referral program earnings, referred users, and leaderboards
  - name: Leaderboard
    description: >-
      Live Unrealized PnL leaderboards for open markets and biggest open
      positions
paths:
  /referral/usdc/me:
    get:
      tags:
        - Referral
      summary: Get My Referral Stats
      description: >-
        Your own referral standing: cumulative CLOB trading volume (the tier
        basis), total USDC earned from the referral program, and the active tier
        ladder. The current tier is not sent - resolve it as the highest ladder
        entry whose minBasisRaw your totalBasisRaw clears.
      operationId: ReferralUsdcController_getMe
      parameters: []
      responses:
        '200':
          description: Referral stats for the authenticated user
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReferralUsdcMeResponseDto'
        '401':
          description: Unauthorized
        '404':
          description: Profile not found
      security:
        - HmacAuth: []
components:
  schemas:
    ReferralUsdcMeResponseDto:
      type: object
      properties:
        customTier:
          type: string
          example: Gold
          description: >-
            Pinned minimum tier name. Present only when a manual tier pin exists
            (for example a partner arrangement). The pin is a floor: the
            effective tier is the higher of this and the volume-derived tier.
        tiers:
          type: array
          items:
            $ref: '#/components/schemas/ReferralUsdcTierLadderEntryDto'
          description: >-
            The active tier ladder, ascending. Render tier progress from this
            instead of hardcoding thresholds.
        totalBasisRaw:
          type: string
          example: '31500000000'
          description: >-
            Your own CLOB trading volume (maker + taker fills) accrued since the
            program start - the tier basis. Raw USDC with 6 decimals, returned
            as a string. Divide by 1e6 for the dollar amount.
        totalEarnedRaw:
          type: string
          example: '184250000'
          description: >-
            Total USDC earned from the referral program across your referred
            users' eligible fills. Raw USDC with 6 decimals, returned as a
            string. Divide by 1e6 for the dollar amount.
      required:
        - tiers
        - totalBasisRaw
        - totalEarnedRaw
    ReferralUsdcTierLadderEntryDto:
      type: object
      properties:
        minBasisRaw:
          type: string
          example: '25000000000'
          description: >-
            Your own CLOB trading volume required to reach this tier. Raw USDC
            with 6 decimals, returned as a string. Divide by 1e6 for the dollar
            amount.
        name:
          type: string
          example: Bronze
          description: Tier name.
        rate:
          type: string
          example: '0.18'
          description: >-
            Referral rate at this tier as a decimal fraction (0.18 = 18% of the
            taker fees your referred users pay).
      required:
        - minBasisRaw
        - name
        - rate
  securitySchemes:
    HmacAuth:
      type: apiKey
      in: header
      name: lmts-api-key
      description: >-
        Scoped API token with HMAC-SHA256 signing. Requires three headers:
        lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature
        (Base64-encoded HMAC). See Authentication docs for details.

````