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

# getLargestAccounts

> Retourne les 20 plus grands comptes, par solde en lamports (les résultats peuvent être mis en cache jusqu'à deux heures).

## Paramètres de la requête

<ParamField body="commitment" type="string">
  Le niveau d'engagement pour la requête.

  * `confirmed`
  * `finalized`
</ParamField>

<ParamField body="filter" type="string">
  Filtrer les résultats par type de compte - soit tous les comptes SOL circulants, soit uniquement des comptes de réserve spéciaux non circulants.

  * `circulating`
  * `nonCirculating`
</ParamField>


## OpenAPI

````yaml fr/openapi/rpc-http/getLargestAccounts.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API d'analyse de la distribution de la richesse pour identifier et
    surveiller les plus grands détenteurs de SOL sur la blockchain Solana avec
    des options de filtrage pour les comptes circulants et de réserve.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Point de terminaison RPC Mainnet
  - url: https://devnet.helius-rpc.com
    description: Point de terminaison RPC Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getLargestAccounts
      description: >-
        Récupérer une liste classée des plus grands détenteurs de SOL sur la
        blockchain Solana. Cette API d'analyse de la richesse fournit des
        informations sur la distribution de SOL en identifiant les comptes
        détenant les soldes les plus significatifs en jetons natifs. Retourne
        les 20 principaux comptes classés par solde SOL, avec des options de
        filtrage entre l'offre en circulation (comptes actifs) et l'offre non
        circulante (comptes de réserve). Essentiel pour les chercheurs de
        marché, les analystes économiques, les observateurs de baleines, les
        études de concentration de richesse et les applications surveillant les
        principaux détenteurs de SOL et leur impact potentiel sur l'économie des
        jetons et les mouvements du marché.
      operationId: getLargestAccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
              properties:
                jsonrpc:
                  type: string
                  description: La version du protocole JSON-RPC.
                  enum:
                    - '2.0'
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Un identifiant unique pour la requête.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  description: Le nom de la méthode RPC à invoquer.
                  enum:
                    - getLargestAccounts
                  example: getLargestAccounts
                  default: getLargestAccounts
                params:
                  type: array
                  description: Objet de configuration optionnel pour filtrer les comptes.
                  default: []
                  items:
                    type: object
                    properties:
                      commitment:
                        type: string
                        description: Le niveau d'engagement pour la requête.
                        enum:
                          - confirmed
                          - finalized
                        example: finalized
                      filter:
                        type: string
                        description: >-
                          Filtrer les résultats par type de compte - soit tous
                          les comptes SOL circulants, soit uniquement des
                          comptes de réserve non circulants.
                        enum:
                          - circulating
                          - nonCirculating
                        example: circulating
      responses:
        '200':
          description: Récupération réussie des plus grands comptes.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: La version du protocole JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Identifiant correspondant à la requête.
                    example: '1'
                  result:
                    type: object
                    description: Liste des plus grands comptes et leurs soldes.
                    properties:
                      context:
                        type: object
                        description: Contexte de la réponse.
                        properties:
                          slot:
                            type: integer
                            description: Le slot auquel les données ont été récupérées.
                            example: 54
                      value:
                        type: array
                        description: >-
                          Top 20 des plus grands comptes Solana classés par
                          solde SOL, du plus élevé au plus bas.
                        items:
                          type: object
                          properties:
                            lamports:
                              type: integer
                              description: >-
                                Solde SOL de ce compte en lamports (1 SOL =
                                1,000,000,000 lamports).
                              example: 999974
                            address:
                              type: string
                              description: >-
                                Adresse unique du portefeuille Solana de ce
                                détenteur majeur de compte.
                              example: 99P8ZgtJYe1buSK8JXkvpLh8xPsCFuLYhz9hQFNw93WJ
        '400':
          description: Bad Request - Paramètres de requête invalides ou requête malformée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: Unauthorized - Clé API invalide ou manquante.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: Too Many Requests - Limite de débit dépassée.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: Internal Server Error - Une erreur s'est produite sur le serveur.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: Service Unavailable - Le service est temporairement indisponible.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '504':
          description: Gateway Timeout - La requête a expiré.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway timeout
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: La version du protocole JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Le code d'erreur.
              example: -32602
            message:
              type: string
              description: Le message d'erreur.
            data:
              type: object
              description: Données supplémentaires sur l'erreur.
        id:
          type: string
          description: Identifiant correspondant à la requête.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Votre clé API Helius. Vous pouvez en obtenir une gratuitement dans le
        [dashboard](https://dashboard.helius.dev/api-keys).

````