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

> Retorna as 20 maiores contas, por saldo de lamports (os resultados podem ser armazenados em cache por até duas horas).

## Parâmetros da Solicitação

<ParamField body="commitment" type="string">
  O nível de compromisso para a solicitação.

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

<ParamField body="filter" type="string">
  Filtra os resultados por tipo de conta - todas as contas SOL circulantes ou apenas contas de reserva especiais não circulantes.

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


## OpenAPI

````yaml pt-BR/openapi/rpc-http/getLargestAccounts.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API de análise de distribuição de riqueza para identificar e monitorar os
    maiores detentores de SOL na blockchain Solana com opções de filtragem para
    contas de circulação e reserva.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Ponto de extremidade Mainnet RPC
  - url: https://devnet.helius-rpc.com
    description: Ponto de extremidade Devnet RPC
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getLargestAccounts
      description: >
        Recupere uma lista ordenada dos maiores detentores de SOL na blockchain
        Solana.

        Esta API de análise de riqueza fornece insights sobre a distribuição de
        SOL identificando as

        contas que detêm os saldos de tokens nativos mais significativos.
        Retorna as 20 principais contas

        classificadas por saldo de SOL, com opções para filtrar entre suprimento
        circulante (contas ativas)

        e suprimento não circulante (contas de reserva). Essencial para
        pesquisadores de mercado, analistas econômicos,

        observadores de baleias, estudos de concentração de riqueza e aplicações
        que monitoram grandes

        detentores de SOL e seu impacto potencial na economia de tokens e
        movimentos de mercado.
      operationId: getLargestAccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
              properties:
                jsonrpc:
                  type: string
                  description: A versão do protocolo JSON-RPC.
                  enum:
                    - '2.0'
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Um identificador único para a solicitação.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  description: O nome do método RPC a ser invocado.
                  enum:
                    - getLargestAccounts
                  example: getLargestAccounts
                  default: getLargestAccounts
                params:
                  type: array
                  description: Objeto de configuração opcional para filtrar contas.
                  default: []
                  items:
                    type: object
                    properties:
                      commitment:
                        type: string
                        description: O nível de compromisso para a solicitação.
                        enum:
                          - confirmed
                          - finalized
                        example: finalized
                      filter:
                        type: string
                        description: >-
                          Filtrar resultados por tipo de conta - todas as contas
                          SOL circulantes ou apenas contas especiais de reserva
                          não circulante.
                        enum:
                          - circulating
                          - nonCirculating
                        example: circulating
      responses:
        '200':
          description: As maiores contas foram recuperadas com sucesso.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: A versão do protocolo JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Identificador correspondente à solicitação.
                    example: '1'
                  result:
                    type: object
                    description: Lista das maiores contas e seus saldos.
                    properties:
                      context:
                        type: object
                        description: Contexto da resposta.
                        properties:
                          slot:
                            type: integer
                            description: O slot no qual os dados foram buscados.
                            example: 54
                      value:
                        type: array
                        description: >-
                          20 maiores contas Solana classificadas por saldo de
                          SOL, da maior para a menor.
                        items:
                          type: object
                          properties:
                            lamports:
                              type: integer
                              description: >-
                                Saldo de SOL desta conta em lamports (1 SOL =
                                1.000.000.000 lamports).
                              example: 999974
                            address:
                              type: string
                              description: >-
                                Endereço único da carteira Solana deste grande
                                titular de conta.
                              example: 99P8ZgtJYe1buSK8JXkvpLh8xPsCFuLYhz9hQFNw93WJ
        '400':
          description: >-
            Requisição Inválida - Parâmetros de solicitação inválidos ou
            solicitação malformada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: Não Autorizado - Chave de API inválida ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: Muitas Solicitações - Limite de taxa excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: Erro Interno do Servidor - Um erro ocorreu no servidor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: Serviço Indisponível - O serviço está temporariamente indisponível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '504':
          description: Tempo Limite do Gateway - O tempo da solicitação esgotou.
          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: A versão do protocolo JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: O código de erro.
              example: -32602
            message:
              type: string
              description: A mensagem de erro.
            data:
              type: object
              description: Dados adicionais sobre o erro.
        id:
          type: string
          description: Identificador correspondente à solicitação.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Sua chave de API Helius. Você pode obter uma gratuitamente no
        [dashboard](https://dashboard.helius.dev/api-keys).

````