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

# Get fee earnings leaderboard

> Get ranked leaderboard of top earners across all tokens and chains



## OpenAPI

````yaml post /get-leaderboard
openapi: 3.0.3
info:
  title: Token Layer API
  version: 1.0.0
  description: |2-

          Token Layer is an omnichain token trading platform where users can create and trade tokens across multiple chains.

          This API provides comprehensive access to token operations, trading, earnings,
          blockchain transactions, and portfolio management.

          ## Base URL
          All endpoints are accessed via: `https://api.tokenlayer.network/{endpoint}`

          ## Authentication
          Most endpoints require authentication using an JWT token or API key passed as a Bearer token in the Authorization header.

          ## Rate Limiting
          API calls are rate limited per user. Please implement appropriate backoff strategies.
        
  contact:
    name: Token Layer API Support
    url: https://app.tokenlayer.network
servers:
  - url: https://api.tokenlayer.network/functions/v1
    description: Production server
  - url: https://api.tokenlayer.network/functions/v1
    description: Staging server
security: []
tags:
  - name: Tokens
    description: Token creation, browsing, search, trading, and price operations
  - name: Transactions
    description: Blockchain transactions (send, tip, ownership checks)
paths:
  /get-leaderboard:
    post:
      tags:
        - Leaderboard
      summary: Get fee earnings leaderboard
      description: Get ranked leaderboard of top earners across all tokens and chains
      operationId: getLeaderboard
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                limit:
                  type: integer
                  minimum: 1
                  maximum: 1000
                  default: 100
                offset:
                  type: integer
                  minimum: 0
                  default: 0
                network_mode:
                  type: string
                  enum:
                    - testnet
                    - mainnet
                    - both
                  default: both
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  leaderboard:
                    type: array
                    items:
                      type: object
                      properties:
                        rank:
                          type: number
                        recipient_address:
                          type: string
                        user_id:
                          type: string
                          nullable: true
                          format: uuid
                        username:
                          type: string
                          nullable: true
                        profile_picture:
                          type: string
                          nullable: true
                        total_earned_all_tokens:
                          type: number
                        unique_chains_count:
                          type: number
                        chain_balances:
                          type: array
                          items:
                            type: object
                            properties:
                              chain:
                                type: string
                              balance:
                                type: number
                            required:
                              - chain
                              - balance
                      required:
                        - rank
                        - recipient_address
                        - user_id
                        - username
                        - profile_picture
                        - total_earned_all_tokens
                        - unique_chains_count
                        - chain_balances
                  pagination:
                    type: object
                    properties:
                      limit:
                        type: number
                      offset:
                        type: number
                      total:
                        type: number
                      has_more:
                        type: boolean
                    required:
                      - limit
                      - offset
                      - total
                      - has_more
                required:
                  - leaderboard
                  - pagination
        '400':
          description: Bad request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
      security:
        - BearerAuth: []
        - {}
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token or API key

````