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

# Wallet - Leaderboard

> '  Retrieve the wallet leaderboard sorted by total asset value in descending order.'

<Tabs>
  <Tab title="Usage Note">
    <p><strong>Wallet leaderboard by total asset value.</strong></p>

    <ul>
      <li><code>limit</code> supports <code>1</code> to <code>100</code>, and <code>offset</code> supports up to <code>10,000</code>.</li>
      <li><code>from\_value</code> defaults to <code>100,000</code> and cannot go below that threshold.</li>
      <li><code>to\_value</code>, when provided, must be greater than <code>from\_value</code>.</li>
      <li>Results are sorted by total asset value in descending order.</li>
    </ul>
  </Tab>

  <Tab title="Accessibility">
    <ul>
      <li>Standard</li>
      <li>Lite</li>
      <li>Starter</li>
      <li>Premium</li>
      <li>Business</li>
      <li>Enterprise</li>
    </ul>
  </Tab>

  <Tab title="Chain Supported">
    <p><strong>Solana</strong></p>
  </Tab>
</Tabs>

<Accordion title="Compute Unit ⚙️" icon="fa-gauge-high">
  <ul>
    <li>This endpoint consumes <code>25 CU</code> per request.</li>
  </ul>
</Accordion>

<Accordion title="Use Cases 💡" icon="fa-lightbulb">
  <ul>
    <li>Build whale leaderboards and wallet-rich-list style screens.</li>
    <li>Slice wallet rankings by value bands for cohort analysis.</li>
    <li>Find large wallets worth investigating further with PnL or funding endpoints.</li>
  </ul>
</Accordion>

<Accordion title="How to Use 🛠️" icon="fa-book-open">
  <ul>
    <li>Set <code>x-chain=solana</code>.</li>
    <li>Use <code>from\_value</code> and optional <code>to\_value</code> to define the wallet band.</li>
    <li>Page through the leaderboard with <code>offset</code> and <code>limit</code>.</li>
  </ul>
</Accordion>

<Accordion title="Best Practices ✅" icon="fa-check-circle">
  <ul>
    <li>Use the leaderboard as a discovery layer, then drill into individual wallets with net-worth and PnL endpoints.</li>
    <li>Keep value bands explicit so comparisons stay meaningful across screens.</li>
  </ul>
</Accordion>

<Accordion title="Limitations ⚠️" icon="fa-exclamation-triangle">
  <ul>
    <li>Solana only.</li>
    <li><code>from\_value</code> has a hard floor of <code>100,000</code>.</li>
  </ul>
</Accordion>

<br />


## OpenAPI

````yaml openapi/data/openapi_docs.json GET /wallet/v2/leaderboard
openapi: 3.1.0
info:
  version: 1.1.0
  title: Birdeye Data API
  description: >-
    Birdeye Data API is a full-spectrum blockchain and DEX data platform for
    teams that need production-grade crypto market intelligence across tokens,
    pairs, wallets, traders, protocols, and chains.


    From real-time prices, OHLCV, liquidity, and transaction flow to holder
    analytics, token and pair overviews, wallet portfolio and PnL, smart money,
    discovery, security, and blockchain-level utilities, Birdeye gives you a
    unified data layer for building serious crypto products at scale.


    Use it to power exchange interfaces, trading terminals, bots, market-making
    systems, quant research, alpha screeners, portfolio apps, wallet
    intelligence tools, alerting systems, analytics dashboards, and back-office
    data pipelines. Whether your users are retail traders, pro desks, analysts,
    or infrastructure teams, Birdeye helps you ship faster with broad market
    coverage and API surfaces that support both lightweight integrations and
    data-heavy workflows.


    To start, create an account at [bds.birdeye.so](https://bds.birdeye.so),
    generate an API key from the `Security` tab, and send it in the `X-API-KEY`
    header on every request.
servers:
  - url: https://public-api.birdeye.so
security:
  - apiKeyAuth: []
tags:
  - name: Price & OHLCV
  - name: Stats
  - name: Token/Market List
  - name: Transactions
  - name: Wallet, Networth & PnL
  - name: Balance & Transfer
  - name: Holder
  - name: Alltime & History
  - name: Blockchain
  - name: Account
  - name: Token
  - name: Transaction
  - name: Creation & Trending
  - name: Meme
  - name: Security
  - name: Search & Utils
  - name: Smart Money
  - name: Global Fees Paid
  - name: DEX & Protocol
  - name: Wallet Identity
paths:
  /wallet/v2/leaderboard:
    get:
      tags:
        - Wallet, Networth & PnL
      summary: Wallet - Leaderboard
      description: '  Retrieve the wallet leaderboard sorted by total asset value in descending order.'
      operationId: get-wallet-v2-leaderboard
      parameters:
        - $ref: '#/components/parameters/xSolanaChainParam'
        - $ref: '#/components/parameters/leaderboardOptionalFromValueParam'
        - $ref: '#/components/parameters/leaderboardOptionalToValueParam'
        - $ref: '#/components/parameters/limit100Default20Param'
        - $ref: '#/components/parameters/onlyOffset10kParam'
      responses:
        '200':
          $ref: '#/components/responses/WalletLeaderboard'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '429':
          $ref: '#/components/responses/429'
        '500':
          $ref: '#/components/responses/500'
components:
  parameters:
    xSolanaChainParam:
      name: x-chain
      description: Solana network only.
      in: header
      required: false
      schema:
        type: string
        enum:
          - solana
        default: solana
    leaderboardOptionalFromValueParam:
      name: from_value
      description: >-
        Minimum total value filter. Defaults to 100,000 and must be greater than
        or equal to 100,000.
      in: query
      required: false
      schema:
        type: number
        format: float
        minimum: 100000
        default: 100000
      example: 110000
    leaderboardOptionalToValueParam:
      name: to_value
      description: >-
        Maximum total value filter. Must be greater than or equal to 100,000 and
        greater than from_value.
      in: query
      required: false
      schema:
        type: number
        format: float
        minimum: 100000
      example: 200000
    limit100Default20Param:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        default: 20
        minimum: 1
        maximum: 100
    onlyOffset10kParam:
      name: offset
      description: Make sure offset <= 10000
      in: query
      required: false
      schema:
        type: integer
        default: 0
        minimum: 0
        maximum: 10000
  responses:
    '400':
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Bad request
    '401':
      description: Unauthorized. API key is missing or invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Unauthorized
    '403':
      description: Forbidden. Request is blacklisted or not whitelisted
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Access Denied
    '429':
      description: Too Many Requests. Rate limit reached
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Too many requests
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            message: Internal Server Error
    WalletLeaderboard:
      description: >-
        JSON object containing the wallet leaderboard ranked by total asset
        value
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/WalletLeaderboardResponseSchema'
          examples:
            Solana:
              value:
                success: true
                data:
                  - owner: 9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM
                    total_value: 3352489812.278252
                  - owner: A3znyaRYUvi7GbQv1pp9CqqiVo7anddU9rPKFH55V28R
                    total_value: 1564819917.2911928
                  - owner: 2RH6rUTPBJ9rUDPpuV9b8z1YL56k1tYU6Uk5ZoaEFFSK
                    total_value: 1483130883.5045538
                  - owner: 5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9
                    total_value: 1147108284.7334204
                  - owner: 7VHUFJHWu2CuExkJcJrzhQPJ2oygupTWkL2A2For4BmE
                    total_value: 945760499.1432049
                  - owner: 7s1da8DduuBFqGra5bJBjpnvL5E9mGzCuMk1Qkh4or2Z
                    total_value: 875194731.5268117
                  - owner: 5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1
                    total_value: 809838920.8587894
                  - owner: CbrKVVDv6irzm4SYv8YnhJkN6wCTnYw9S7SqdwavCrRt
                    total_value: 744786294.4507848
                  - owner: WLHv2UAZm6z4KyaaELi5pjdbJh6RESMva1Rnn8pJVVh
                    total_value: 680821233.5398307
                  - owner: 9DrvZvyWh1HuAoZxvYWMvkf2XCzryCpGgHqrMjyDWpmo
                    total_value: 665974893.9983461
                  - owner: 7mhcgF1DVsj5iv4CxZDgp51H6MBBwqamsH1KnqXhSRc5
                    total_value: 642357546.305955
                  - owner: AVzP2GeRmqGphJsMxWoqjpUifPpCret7LqWhD8NWQK49
                    total_value: 638620660.7627872
                  - owner: Cfq1ts1iFr1eUWWBm8eFxUzm5R3YA3UvMZznwiShbgZt
                    total_value: 619044607.6657771
                  - owner: S7vYFFWH6BjJyEsdrPQpqpYTqLTrPRK6KW3VwsJuRaS
                    total_value: 532792174.87978095
                  - owner: FhVo3mqL8PW5pH5U2CN4XE33DokiyZnUwuGpH2hmHLuM
                    total_value: 503459404.00368106
                  - owner: 29koCwp2k6G8vnewSDJUdusWw6RKpi83CkAcXfokeF2A
                    total_value: 426470848.522809
                  - owner: 5gUuDFHswKi2QMA1qJHf6FEVhNCrHnyAdfWniMaUUPE4
                    total_value: 420289058.432106
                  - owner: 51yZyDSnec4xnUv7XLRVYcDyV4x3wUtzrDcRaYbmQU5j
                    total_value: 402965606.3338358
                  - owner: H8BgJgae6qhMtf7BM2JtddywSQt11WdxHHxkGLNX5hss
                    total_value: 387663654.9940434
                  - owner: 6LY1JzAFVZsP2a2xKrtU6znQMQ5h4i7tocWdgrkZzkzF
                    total_value: 374231197.1905912
  schemas:
    WalletLeaderboardResponseSchema:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          description: Whether the request succeeded.
        data:
          type: array
          description: Ranked wallets for the requested leaderboard scope.
          items:
            type: object
            properties:
              owner:
                type: string
                description: Wallet address in the leaderboard.
              total_value:
                type: number
                description: Total USD value used for ranking.
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY
      description: API key for authentication

````