getClusterNodes

POSTNetwork & ClusterAll plans

Lists every node visible in the cluster's gossip network, with its ports and client version.

Try itSends a real request from your browser to the selected region.
POST
/

getClusterNodes returns one entry per node visible in gossip: identity pubkey, advertised gossip/TPU/RPC addresses, and client version and feature set. This includes every visible node, not only actively voting validators.

This is a fleet-wide call that serializes the whole node list on every request; getVoteAccounts covers active, staked validators only, at lower cost.

Plans & rate limitsAll plans
Free5/s
Operator50/s
Blade Runner200/s
Nexus500/s

Parameters

This method takes no parameters.

Result

resultobject[]

An array of contact-info objects, one per node visible in gossip.

Show each itemEach item
pubkeystringrequired

Node's identity public key, base-58 encoded.

gossipstring | null

Gossip network address (host:port), or null if not advertised.

tpustring | null

TPU (transaction processing unit) address for UDP transactions, or null.

tpuQuicstring | null

TPU address for QUIC transactions, or null.

tpuForwardsstring | null

TPU forwarding address for UDP, or null.

tpuForwardsQuicstring | null

TPU forwarding address for QUIC, or null.

rpcstring | null

JSON-RPC address, or null if the node does not serve RPC.

pubsubstring | null

WebSocket PubSub address, or null if the node does not serve subscriptions.

versionstring | null

Client version string the node announced, or null if unknown.

featureSetinteger | null

Feature-set identifier the node announced, or null if unknown.

shredVersioninteger | nullrequired

16-bit shred version. Nodes with a mismatched shred version are on a different fork/hard-fork lineage and won't turbine shreds to each other.

Notes

  • A full mainnet-beta response lists several thousand nodes and can be multi-megabyte; this example is trimmed to two entries.
  • rpc and pubsub are null for the large majority of nodes: most cluster participants are validators that don't serve public RPC traffic at all.
  • shredVersion identifies a node that has forked away from the expected cluster.