rootSubscribe

rootSubscribe — Subscribe to root slot updates

post

wss://public.rpc.solanavibestation.comwss://lite.rpc.solanavibestation.comwss://basic.rpc.solanavibestation.comwss://ultra.rpc.solanavibestation.comwss://elite.rpc.solanavibestation.comwss://epic.rpc.solanavibestation.com

/

Subscribe to receive notification anytime a new root is set by the validator. This method establishes a persistent WebSocket connection that will send real-time notifications whenever the validator updates the root slot. The root represents the most recent slot that has been finalized and committed to the ledger. This subscription is useful for tracking the overall progress of the blockchain and understanding when transactions become irreversibly confirmed.

Authorizations

AuthHeaderURLParameter

AuthorizationstringOptional

Pass Authorization: <api-key> on each request.

Body

application/json

jsonrpcstring · enumRequired

JSON-RPC protocol version.

Example: 2.0Possible values:

idone ofRequired

Request identifier echoed back in the response.

Example: 1

stringOptional

or

integerOptional

methodstring · enumRequired

Must be rootSubscribe.

Example: rootSubscribePossible values:

paramsarrayRequired

No parameters.

Responses

200

Successful rootSubscribe response.

application/json

Base envelope of every JSON-RPC 2.0 response.

jsonrpcstring · enumRequiredExample: 2.0Possible values:

idone ofRequired

Echoed request id.

Example: 1

stringOptional

or

integerOptional

resultinteger · int64Required

Subscription id. Save this value to call the matching unsubscribe method later.

Example: 24040

401

Authentication required or invalid.

application/json

403

Insufficient permissions for the request.

application/json

429

Rate limit exceeded for this tier.

application/json

500

Unexpected server error.

application/json

post

/

cURL / websocatPythonJavaScriptRust

# cURL doesn't speak WebSocket — use `websocat` (or `wscat -c`).
# Install:  cargo install websocat   # or  npm install -g wscat
echo '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "rootSubscribe",
  "params": []
}' | websocat wss://public.rpc.solanavibestation.com

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": 24040
}