Parameters

This method does not accept any parameters

Returns

result

array

An array of JSON objects, each describing a cluster node.

clientId

string

The name of the validator client (for example, Agave)

featureSet

integer

The unique identifier of the node's feature set

gossip

string | null

The gossip network address for the node. Null if not available

pubkey

string

The public key of the node encoded as base-58 string

pubsub

string | null

The pubsub network address for the node. Null if pubsub is not enabled

rpc

string | null

The IP address and port number of the node's JSON-RPC service. Null if the JSON RPC service is not enabled

serveRepair

string | null

The serve-repair network address for the node. Null if not available

shredVersion

integer

The version of the data structure used by this node to store and transmit blocks

tpu

string | null

The TPU network address for the node. Null if not available

tpuForwards

string | null

The TPU forwards network address for the node. Null if not available

tpuForwardsQuic

string | null

The TPU forwards QUIC network address for the node. Null if not available

tpuQuic

string | null

The TPU QUIC network address for the node. Null if not available

tpuVote

string | null

The TPU vote network address for the node. Null if not available

tvu

string | null

The TVU network address for the node. Null if not available

version

string | null

The software version of the node. Null if the version information is not available

Request

1
curl https://docs-demo.solana-devnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"jsonrpc":"2.0", "id":1, "method":"getClusterNodes"}'

1
curl https://docs-demo.solana-devnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{"jsonrpc":"2.0", "id":1, "method":"getClusterNodes"}'

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.solana-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getClusterNodes"
16
})
17

18
response = https.request(request)
19
puts response.read_body
20

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.solana-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "jsonrpc": "2.0",
14
  "id": 1,
15
  "method": "getClusterNodes"
16
})
17

18
response = https.request(request)
19
puts response.read_body
20

1
const web3 = require("@solana/web3.js");
2
(async () => {
3
  const solana = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
4
  console.log(await solana.getClusterNodes());
5
})();
6

1
const web3 = require("@solana/web3.js");
2
(async () => {
3
  const solana = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/");
4
  console.log(await solana.getClusterNodes());
5
})();
6

1
import { createSolanaRpc } from "@solana/kit";
2

3
(async () => {
4
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
5
  
6
  try {
7
    const clusterNodes = await solanaRpc.getClusterNodes().send();
8
    console.log(clusterNodes);
9
  } catch (error) {
10
    console.error("Error fetching cluster nodes:", error);
11
  }
12
})();

1
import { createSolanaRpc } from "@solana/kit";
2

3
(async () => {
4
  const solanaRpc = createSolanaRpc("https://docs-demo.solana-mainnet.quiknode.pro/");
5
  
6
  try {
7
    const clusterNodes = await solanaRpc.getClusterNodes().send();
8
    console.log(clusterNodes);
9
  } catch (error) {
10
    console.error("Error fetching cluster nodes:", error);
11
  }
12
})();

1
from solana.rpc.api import Client
2
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
3
print(solana_client.get_cluster_nodes())

1
from solana.rpc.api import Client
2
solana_client = Client("https://docs-demo.solana-mainnet.quiknode.pro/")
3
print(solana_client.get_cluster_nodes())

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

5
#[tokio::main]
6
async fn main() -> Result<(), Box<dyn Error>> {
7
    let mut headers = header::HeaderMap::new();
8
    headers.insert("Content-Type", "application/json".parse().unwrap());
9

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getClusterNodes"
16
    }
17
    "#;
18
    let response = client
19
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
20
        .headers(headers)
21
        .body(json_data)
22
        .send()
23
        .await?; 
24

25
    let body = response.text().await?;
26
    println!("{}", body);
27

28
    Ok(())
29
}
30

1
use reqwest::header;
2
use reqwest::Client;
3
use std::error::Error;
4

5
#[tokio::main]
6
async fn main() -> Result<(), Box<dyn Error>> {
7
    let mut headers = header::HeaderMap::new();
8
    headers.insert("Content-Type", "application/json".parse().unwrap());
9

10
    let client = Client::new();
11
    let json_data = r#"
12
    {
13
        "jsonrpc": "2.0",
14
        "id": 1,
15
        "method": "getClusterNodes"
16
    }
17
    "#;
18
    let response = client
19
        .post("https://docs-demo.solana-mainnet.quiknode.pro/")
20
        .headers(headers)
21
        .body(json_data)
22
        .send()
23
        .await?; 
24

25
    let body = response.text().await?;
26
    println!("{}", body);
27

28
    Ok(())
29
}
30

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getClusterNodes',
7
  [],
8
  undefined,
9
  'https://docs-demo.solana-mainnet.quiknode.pro/'
10
)
11

12
console.log(result)

1
import { QuicknodeSdk } from '@quicknode/sdk'
2

3
const qn = new QuicknodeSdk({})
4

5
const result = await qn.rpc.call(
6
  'getClusterNodes',
7
  [],
8
  undefined,
9
  'https://docs-demo.solana-mainnet.quiknode.pro/'
10
)
11

12
console.log(result)

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getClusterNodes",
8
        [],
9
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
10
    )
11
    print(result)
12

13
asyncio.run(main())

1
import asyncio
2
from quicknode_sdk import QuicknodeSdk, SdkFullConfig
3

4
async def main():
5
    qn = QuicknodeSdk(SdkFullConfig(api_key=None))
6
    result = await qn.rpc.call(
7
        "getClusterNodes",
8
        [],
9
        endpoint_url="https://docs-demo.solana-mainnet.quiknode.pro/",
10
    )
11
    print(result)
12

13
asyncio.run(main())

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getClusterNodes",
7
  params: [],
8
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
9
)
10

11
puts result

1
require "quicknode_sdk"
2

3
qn = QuicknodeSdk::SDK.from_config(api_key: nil)
4

5
result = qn.rpc.call(
6
  method: "getClusterNodes",
7
  params: [],
8
  endpoint_url: "https://docs-demo.solana-mainnet.quiknode.pro/"
9
)
10

11
puts result

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getClusterNodes",
10
            Some(serde_json::json!([])),
11
            None,
12
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
13
        )
14
        .await?;
15

16
    println!("{result}");
17
    Ok(())
18
}

1
use quicknode_sdk::{QuicknodeSdk, SdkFullConfig};
2

3
#[tokio::main]
4
async fn main() -> Result<(), Box<dyn std::error::Error>> {
5
    let qn = QuicknodeSdk::new(&SdkFullConfig::keyless())?;
6
    let result = qn
7
        .rpc
8
        .call(
9
            "getClusterNodes",
10
            Some(serde_json::json!([])),
11
            None,
12
            Some("https://docs-demo.solana-mainnet.quiknode.pro/".into()),
13
        )
14
        .await?;
15

16
    println!("{result}");
17
    Ok(())
18
}

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": [
4
    {
5
      "clientId": "Agave",
6
      "featureSet": 3383571666,
7
      "gossip": "38.248.91.223:8001",
8
      "pubkey": "CM1esAX41hFy9dt3VoqCHJ7FzxrQuBgezZrW14fVau5v",
9
      "pubsub": null,
10
      "rpc": null,
11
      "serveRepair": "38.248.91.223:8009",
12
      "shredVersion": 7016,
13
      "tpu": null,
14
      "tpuForwards": null,
15
      "tpuForwardsQuic": "38.248.91.223:8004",
16
      "tpuQuic": "38.248.91.223:8003",
17
      "tpuVote": "38.248.91.223:8005",
18
      "tvu": "38.248.91.223:8002",
19
      "version": "4.3.0"
20
    }
21
  ],
22
  "id": 1
23
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": [
4
    {
5
      "clientId": "Agave",
6
      "featureSet": 3383571666,
7
      "gossip": "38.248.91.223:8001",
8
      "pubkey": "CM1esAX41hFy9dt3VoqCHJ7FzxrQuBgezZrW14fVau5v",
9
      "pubsub": null,
10
      "rpc": null,
11
      "serveRepair": "38.248.91.223:8009",
12
      "shredVersion": 7016,
13
      "tpu": null,
14
      "tpuForwards": null,
15
      "tpuForwardsQuic": "38.248.91.223:8004",
16
      "tpuQuic": "38.248.91.223:8003",
17
      "tpuVote": "38.248.91.223:8005",
18
      "tvu": "38.248.91.223:8002",
19
      "version": "4.3.0"
20
    }
21
  ],
22
  "id": 1
23
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free