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

> Devuelve las 20 cuentas más grandes por saldo en lamports (los resultados pueden almacenarse en caché hasta por dos horas).

## Parámetros de la solicitud

<ParamField body="commitment" type="string">
  El nivel de compromiso de la solicitud.

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

<ParamField body="filter" type="string">
  Filtra los resultados por tipo de cuenta: todas las cuentas de SOL circulante o solo las cuentas especiales de reserva no circulante.

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


## OpenAPI

````yaml es/openapi/rpc-http/getLargestAccounts.yaml POST /
openapi: 3.1.0
info:
  title: API RPC de Solana
  version: 1.0.0
  description: >-
    API de análisis de distribución de riqueza para identificar y monitorear a
    los mayores poseedores de SOL en la blockchain de Solana, con opciones de
    filtrado para cuentas en circulación y de reserva.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Punto de conexión RPC de Mainnet
  - url: https://devnet.helius-rpc.com
    description: Punto de conexión RPC de Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getLargestAccounts
      description: >
        Obtén una lista ordenada de los mayores poseedores de SOL en la
        blockchain de Solana.

        Esta API de análisis de riqueza proporciona información sobre la
        distribución de SOL mediante la identificación de las

        cuentas que tienen los saldos más grandes del token nativo. Devuelve las
        20 cuentas principales

        ordenadas por saldo de SOL, con opciones para filtrar entre el
        suministro en circulación (cuentas activas)

        y el suministro fuera de circulación (cuentas de reserva). Es esencial
        para investigadores de mercado, analistas

        económicos, observadores de ballenas, estudios sobre concentración de
        riqueza y aplicaciones que monitorean a los principales

        poseedores de SOL y su posible impacto en la economía del token y los
        movimientos del mercado.
      operationId: getLargestAccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
              properties:
                jsonrpc:
                  type: string
                  description: La versión del protocolo JSON-RPC.
                  enum:
                    - '2.0'
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Un identificador único para la solicitud.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  description: El nombre del método RPC que se invocará.
                  enum:
                    - getLargestAccounts
                  example: getLargestAccounts
                  default: getLargestAccounts
                params:
                  type: array
                  description: Objeto de configuración opcional para filtrar cuentas.
                  default: []
                  items:
                    type: object
                    properties:
                      commitment:
                        type: string
                        description: El nivel de confirmación de la solicitud.
                        enum:
                          - confirmed
                          - finalized
                        example: finalized
                      filter:
                        type: string
                        description: >-
                          Filtra los resultados por tipo de cuenta: todas las
                          cuentas de SOL en circulación o solo las cuentas
                          especiales de reserva fuera de circulación.
                        enum:
                          - circulating
                          - nonCirculating
                        example: circulating
      responses:
        '200':
          description: Las cuentas con mayor saldo se obtuvieron correctamente.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: La versión del protocolo JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Identificador que coincide con la solicitud.
                    example: '1'
                  result:
                    type: object
                    description: Lista de las cuentas con mayor saldo y sus saldos.
                    properties:
                      context:
                        type: object
                        description: Contexto de la respuesta.
                        properties:
                          slot:
                            type: integer
                            description: El slot en el que se obtuvieron los datos.
                            example: 54
                      value:
                        type: array
                        description: >-
                          Las 20 cuentas de Solana con mayor saldo, ordenadas
                          por saldo de SOL de mayor a menor.
                        items:
                          type: object
                          properties:
                            lamports:
                              type: integer
                              description: >-
                                Saldo de SOL de esta cuenta en lamports (1 SOL =
                                1,000,000,000 lamports).
                              example: 999974
                            address:
                              type: string
                              description: >-
                                Dirección única de la billetera de Solana de
                                este importante titular de cuenta.
                              example: 99P8ZgtJYe1buSK8JXkvpLh8xPsCFuLYhz9hQFNw93WJ
        '400':
          description: >-
            Solicitud incorrecta: parámetros de solicitud no válidos o solicitud
            con formato incorrecto.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: 'No autorizado: la clave de API no es válida o no se proporcionó.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: 'Demasiadas solicitudes: se superó el límite de solicitudes.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: 'Error interno del servidor: se produjo un error en el servidor.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: >-
            Servicio no disponible: el servicio no está disponible
            temporalmente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '504':
          description: >-
            Tiempo de espera de la puerta de enlace agotado: se agotó el tiempo
            de espera de la solicitud.
          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 versión del protocolo JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: El código de error.
              example: -32602
            message:
              type: string
              description: El mensaje de error.
            data:
              type: object
              description: Datos adicionales sobre el error.
        id:
          type: string
          description: Identificador que coincide con la solicitud.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Tu clave de API de Helius. Puedes obtener una gratis en el
        [panel](https://dashboard.helius.dev/api-keys).

````