getHealth

getHealth is a Solana JSON-RPC method that reports whether an RPC node is caught up with the rest of the cluster. It returns the string "ok" when the node is keeping pace with the ~400ms slots that advance the SOL ledger, or a JSON-RPC error when it has fallen too many slots behind. It is the lightest possible probe for load balancing — no parameters, no commitment, just a fast yes/no signal. Send it as a JSON-RPC 2.0 POST with an empty positional params array to https://solana.therpc.io/YOUR_API_KEY.

Use cases

• Health-check an RPC endpoint before routing live Solana traffic to it, so requests never land on a node that is silently behind.
• Drive a load balancer's readiness probe: drop a node from rotation the moment getHealth stops returning "ok".
• Fire an alert when a node falls behind the cluster, since a non-"ok" response means it is lagging the latest slots.

Parameters

This method takes no parameters. Pass an empty array [].

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": "getHealth",
8  "params": []
9}'

Errors & troubleshooting

Common pitfalls

• An unhealthy node responds with a JSON-RPC error object instead of a "ok" result, so read the error field, not just result — a client that only inspects result will misread a lagging node as healthy.
• "ok" only means the node is caught up enough on slots; it is not a deep correctness guarantee, so do not treat it as proof that every account or transaction query will be fully accurate.

Supported networks

• Mainnet
• Devnet

See also

• getVersion
• getSlot