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

> Gibt Informationen über alle Knoten im Cluster zurück.



## OpenAPI

````yaml de/openapi/rpc-http/getClusterNodes.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    Netzwerkerkennungs-API zum Abrufen einer umfassenden Liste aktiver
    Solana-Validator-Knoten mit ihren Netzwerkadressen, Versionen und
    Verbindungspunkten.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Mainnet-RPC-Endpunkt
  - url: https://devnet.helius-rpc.com
    description: Devnet-RPC-Endpunkt
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getClusterNodes
      description: >
        Abrufen detaillierter Informationen über alle aktiven Validator-Knoten
        im Solana-Netzwerk.

        Diese Netzwerktopologie-API bietet eine vollständige Abbildung der
        aktuellen Validator-Landschaft,

        indem sie wesentliche Verbindungsdetails für jeden teilnehmenden Knoten
        zurückgibt. Informationen umfassen

        Validator-öffentliche Schlüssel, Netzwerkadressen für verschiedene
        Protokolle (Gossip, TPU, RPC),

        Softwareversionen und Funktionssätze. Wesentlich für
        Netzwerküberwachungstools, Validator-

        Statistik-Dashboards, Client-Bibliotheken zur Implementierung
        intelligenter Knotenauswahl, Netzwerkt

        ertools, die direkte Kommunikation mit Validatoren benötigen, und
        Anwendungen, die das geografische und Versions-Verteilung des
        Solana-Validator-Netzwerks verstehen möchten.
      operationId: getClusterNodes
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
              properties:
                jsonrpc:
                  type: string
                  description: Die JSON-RPC-Protokollversion.
                  enum:
                    - '2.0'
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: Eine eindeutige Kennung für die Anfrage.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  description: Der Name der RPC-Methode, die aufgerufen werden soll.
                  enum:
                    - getClusterNodes
                  example: getClusterNodes
                  default: getClusterNodes
      responses:
        '200':
          description: Erfolgreich Clusterknoteninformationen abgerufen.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: Die JSON-RPC-Protokollversion.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Kennung, die der Anfrage entspricht.
                    example: '1'
                  result:
                    type: array
                    description: >-
                      Umfassende Liste aller erkennbaren
                      Solana-Validator-Knoten, die derzeit am Netzwerk
                      teilnehmen.
                    items:
                      type: object
                      properties:
                        pubkey:
                          type: string
                          description: >-
                            Eindeutiger Validator-Identitätsschlüssel (base-58
                            codiert), der diesen Knoten im Solana-Netzwerk
                            identifiziert.
                          example: 9QzsJf7LPLj8GkXbYT3LFDKqsj2hHG7TA3xinJHu8epQ
                        gossip:
                          type: string
                          nullable: true
                          description: >-
                            IP-Adresse und Port zur Verbindung mit dem
                            Gossip-Protokollendpunkt dieses Validators zur
                            Peererkennung.
                          example: 10.239.6.48:8001
                        tpu:
                          type: string
                          nullable: true
                          description: >-
                            Adresse der Transaktionsverarbeitungseinheit, an die
                            Clients Transaktionen direkt an diesen Validator
                            übermitteln können.
                          example: 10.239.6.48:8856
                        rpc:
                          type: string
                          nullable: true
                          description: >-
                            JSON-RPC-API-Endpunktadresse, falls dieser Validator
                            öffentliche RPC-Dienste anbietet, oder null, falls
                            nicht öffentlich verfügbar.
                          example: 10.239.6.48:8899
                        version:
                          type: string
                          nullable: true
                          description: >-
                            Solana-Softwareversion und Build-Kennung, die auf
                            diesem Validator-Knoten ausgeführt wird.
                          example: 1.0.0 c375ce1f
                        featureSet:
                          type: integer
                          nullable: true
                          description: >-
                            Numerische Kennung des Funktionssatzes, der auf
                            diesem Validator aktiviert ist, um die
                            Protokollkompatibilität zu verfolgen.
                        shredVersion:
                          type: integer
                          nullable: true
                          description: >-
                            Netzwerkkompatibilitätsversionsnummer, die für die
                            Verarbeitung und Weiterleitung von Shreds zwischen
                            Validator-Knoten verwendet wird.
        '400':
          description: >-
            Schlechte Anfrage - Unzulässige Anfrageparameter oder fehlerhafte
            Anfrage.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Ungültige Parameter
                id: '1'
        '401':
          description: Nicht autorisiert - Ungültiger oder fehlender API-Schlüssel.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Nicht autorisiert
                id: '1'
        '429':
          description: Zu viele Anfragen - Ratenlimit überschritten.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Zu viele Anfragen
                id: '1'
        '500':
          description: Interner Serverfehler - Ein Fehler ist auf dem Server aufgetreten.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Interner Fehler
                id: '1'
        '503':
          description: >-
            Dienst nicht verfügbar - Der Dienst ist vorübergehend nicht
            verfügbar.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Dienst nicht verfügbar
                id: '1'
        '504':
          description: >-
            Gateway-Zeitüberschreitung - Die Anfrage hat die Zeitüberschreitung
            überschritten.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway-Zeitüberschreitung
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: Die JSON-RPC-Protokollversion.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Fehlercode.
            message:
              type: string
              description: Fehlermeldung.
        id:
          type: string
          description: Kennung, die der Anfrage entspricht.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Ihr Helius-API-Schlüssel. Sie können einen kostenlosen im
        [Dashboard](https://dashboard.helius.dev/api-keys) erhalten.

````