getClusterNodes

getClusterNodes is a Solana JSON-RPC method that returns information about every node currently participating in the cluster — the validators and RPC nodes that secure the SOL ledger under Proof-of-History and Proof-of-Stake. For each node you get its identity pubkey along with the network addresses it advertises through gossip: the gossip, tpu, and rpc ports, plus the version, featureSet, and shredVersion it is running. Send the request as a JSON-RPC 2.0 POST with an empty positional params array to https://solana.therpc.io/YOUR_API_KEY.

Use cases

• Discover the rpc and tpu endpoints advertised across the cluster, for example to send a transaction straight to a leader's TPU port instead of waiting on a generic RPC.
• Audit which solana-core version and featureSet each node runs network-wide, so you can spot validators lagging an upgrade.
• Map the gossip topology by identity pubkey to feed a monitoring or explorer-style tool that tracks cluster membership over time.

Parameters

Este método no acepta parámetros. Pasa un array vacío [].

Response

Example request

1curl https://solana.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "method": "getClusterNodes",
8  "params": []
9}'

Errors & troubleshooting

Common pitfalls

• The rpc and tpu fields can be null for nodes that do not expose those ports publicly — a validator with RPC disabled will report rpc: null, so guard against it before dialing the address.
• On Solana mainnet this list runs to thousands of nodes and changes constantly as validators join, leave, and restart. Cache the response for a short window rather than calling it on every request.

Supported networks

• Mainnet
• Devnet

See also

• getVersion
• getIdentity
• getVoteAccounts