getClusterNodes Solana RPC Method

POST

getClusterNodes

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getClusterNodes"
}
'

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": [
    {
      "pubkey": "9QzsJf7LPLj8GkXbYT3LFDKqsj2hHG7TA3xinJHu8epQ",
      "gossip": "10.239.6.48:8001",
      "tpu": "10.239.6.48:8856",
      "rpc": "10.239.6.48:8899",
      "version": "1.0.0 c375ce1f",
      "featureSet": 123,
      "shredVersion": 123
    }
  ]
}

Authorizations

api-key

string

query

required

Your Helius API key. You can get one for free in the dashboard.

Body

application/json

jsonrpc

enum<string>

default:2.0

required

The JSON-RPC protocol version.

Available options:

2.0

Example:

"2.0"

string

default:1

required

A unique identifier for the request.

Example:

"1"

method

enum<string>

default:getClusterNodes

required

The name of the RPC method to invoke.

Available options:

getClusterNodes

Example:

"getClusterNodes"

Response

Successfully retrieved cluster node information.

jsonrpc

enum<string>

The JSON-RPC protocol version.

Available options:

2.0

Example:

"2.0"

string

Identifier matching the request.

Example:

"1"

result

object[]

Comprehensive list of all discoverable Solana validator nodes currently participating in the network.

Show child attributes

result.pubkey

string

Unique validator identity public key (base-58 encoded) that identifies this node on the Solana network.

Example:

"9QzsJf7LPLj8GkXbYT3LFDKqsj2hHG7TA3xinJHu8epQ"

result.gossip

string | null

IP address and port for connecting to this validator's gossip protocol endpoint for peer discovery.

Example:

"10.239.6.48:8001"

result.tpu

string | null

Transaction Processing Unit address where clients can directly submit transactions to this validator.

Example:

"10.239.6.48:8856"

result.rpc

string | null

JSON-RPC API endpoint address if this validator offers public RPC services, or null if not publicly available.

Example:

"10.239.6.48:8899"

result.version

string | null

Solana software version and build identifier running on this validator node.

Example:

"1.0.0 c375ce1f"

result.featureSet

integer | null

Numeric identifier of the feature set enabled on this validator, used to track protocol compatibility.

result.shredVersion

integer | null

Network compatibility version number used for shred processing and routing between validator nodes.

getEpochInfoReturns information about the current epoch.

⌘I

getClusterNodes

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getClusterNodes"
}
'

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": [
    {
      "pubkey": "9QzsJf7LPLj8GkXbYT3LFDKqsj2hHG7TA3xinJHu8epQ",
      "gossip": "10.239.6.48:8001",
      "tpu": "10.239.6.48:8856",
      "rpc": "10.239.6.48:8899",
      "version": "1.0.0 c375ce1f",
      "featureSet": 123,
      "shredVersion": 123
    }
  ]
}

API Reference

Solana RPC APIs

Solana APIs

Data Streaming APIs

Event Listening APIs

Deprecated APIs

getClusterNodes

Authorizations

Body

Response