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

# getClusterNodes

> Devuelve información sobre todos los nodos que participan en el clúster.



## OpenAPI

````yaml es/openapi/rpc-http/getClusterNodes.yaml POST /
openapi: 3.1.0
info:
  title: API RPC de Solana
  version: 1.0.0
  description: >-
    API de descubrimiento de red para obtener una lista completa de los nodos
    validadores activos de Solana, junto con sus direcciones de red, versiones y
    endpoints de conectividad.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Endpoint RPC de Mainnet
  - url: https://devnet.helius-rpc.com
    description: Endpoint RPC de Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getClusterNodes
      description: >
        Obtén información detallada sobre todos los nodos validadores activos de
        la red Solana.

        Esta API de topología de red proporciona un mapa completo del panorama
        actual de validadores

        y devuelve datos esenciales de conectividad para cada nodo participante.
        La información incluye

        las claves públicas de los validadores, las direcciones de red para
        distintos protocolos (gossip, TPU, RPC),

        las versiones de software y los conjuntos de funcionalidades. Es
        esencial para herramientas de monitoreo de red, paneles

        de estadísticas de validadores, bibliotecas cliente que implementan una
        selección inteligente de nodos, herramientas

        de red que necesitan comunicación directa con validadores y aplicaciones
        que buscan comprender

        la distribución geográfica y de versiones de la red de validadores de
        Solana.
      operationId: getClusterNodes
      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:
                    - getClusterNodes
                  example: getClusterNodes
                  default: getClusterNodes
      responses:
        '200':
          description: La información de los nodos del clúster se obtuvo 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: array
                    description: >-
                      Lista completa de todos los nodos validadores de Solana
                      detectables que participan actualmente en la red.
                    items:
                      type: object
                      properties:
                        pubkey:
                          type: string
                          description: >-
                            Clave pública única de identidad del validador
                            (codificada en base 58) que identifica este nodo en
                            la red Solana.
                          example: 9QzsJf7LPLj8GkXbYT3LFDKqsj2hHG7TA3xinJHu8epQ
                        gossip:
                          type: string
                          nullable: true
                          description: >-
                            Dirección IP y puerto para conectarse al endpoint
                            del protocolo gossip de este validador y descubrir
                            pares.
                          example: 10.239.6.48:8001
                        tpu:
                          type: string
                          nullable: true
                          description: >-
                            Dirección de la unidad de procesamiento de
                            transacciones a la que los clientes pueden enviar
                            transacciones directamente para este validador.
                          example: 10.239.6.48:8856
                        rpc:
                          type: string
                          nullable: true
                          description: >-
                            Dirección del endpoint de la API JSON-RPC si este
                            validador ofrece servicios RPC públicos, o null si
                            no está disponible públicamente.
                          example: 10.239.6.48:8899
                        version:
                          type: string
                          nullable: true
                          description: >-
                            Versión del software de Solana e identificador de
                            compilación que se ejecutan en este nodo validador.
                          example: 1.0.0 c375ce1f
                        featureSet:
                          type: integer
                          nullable: true
                          description: >-
                            Identificador numérico del conjunto de
                            funcionalidades habilitado en este validador,
                            utilizado para realizar un seguimiento de la
                            compatibilidad del protocolo.
                        shredVersion:
                          type: integer
                          nullable: true
                          description: >-
                            Número de versión de compatibilidad de red utilizado
                            para procesar y enrutar shreds entre nodos
                            validadores.
        '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: Parámetros no válidos
                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: No autorizado
                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: Demasiadas solicitudes
                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: Error interno
                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: Servicio no disponible
                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: Tiempo de espera de la puerta de enlace agotado
                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: Código de error.
            message:
              type: string
              description: Mensaje de 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).

````