As of May 1, 2026, this WebSocket method is billed based on metered data usage: 0.1 MB = 15 API credits. Learn more about WebSocket billing.

Parameters

This method does not accept any parameters

Returns

result

integer

The result will be an RpcResponse JSON object with id equal to the subscription id (needed to unsubscribe)

Notification Format:

The notification format is the same as seen in the getAccountInfo RPC HTTP method

slot

The latest slot number

Request

1
const web3 = require("@solana/web3.js");
2
(async () => {
3
  const solanaConnection = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/", {
4
    wsEndpoint: "",
5
  });
6
  solanaConnection.onRootChange((rootInfo) =>
7
    console.log("Updated slot info: ", rootInfo)
8
  );
9
})();
10

1
const web3 = require("@solana/web3.js");
2
(async () => {
3
  const solanaConnection = new web3.Connection("https://docs-demo.solana-mainnet.quiknode.pro/", {
4
    wsEndpoint: "",
5
  });
6
  solanaConnection.onRootChange((rootInfo) =>
7
    console.log("Updated slot info: ", rootInfo)
8
  );
9
})();
10

1
import { createSolanaRpcSubscriptions } from '@solana/kit';
2

3
const rpcSubscriptions = createSolanaRpcSubscriptions('');
4

5
async function main() {
6
    const abortController = new AbortController();
7

8
    const subscription = await rpcSubscriptions
9
        .rootNotifications()
10
        .subscribe({ abortSignal: abortController.signal });
11

12
    try {
13
        for await (const notification of subscription) {
14
            console.log("Updated root info: ", notification);
15
        }
16
    } catch (e) {
17
        console.error("Error in root subscription:", e);
18
    } finally {
19
        abortController.abort();
20
        console.log('Unsubscribed from root changes');
21
    }
22
}
23

24
main().catch(console.error);

1
import { createSolanaRpcSubscriptions } from '@solana/kit';
2

3
const rpcSubscriptions = createSolanaRpcSubscriptions('');
4

5
async function main() {
6
    const abortController = new AbortController();
7

8
    const subscription = await rpcSubscriptions
9
        .rootNotifications()
10
        .subscribe({ abortSignal: abortController.signal });
11

12
    try {
13
        for await (const notification of subscription) {
14
            console.log("Updated root info: ", notification);
15
        }
16
    } catch (e) {
17
        console.error("Error in root subscription:", e);
18
    } finally {
19
        abortController.abort();
20
        console.log('Unsubscribed from root changes');
21
    }
22
}
23

24
main().catch(console.error);

1
import solana
2
import asyncio
3
from asyncstdlib import enumerate
4
from solana.rpc.websocket_api import connect
5

6
async def main():
7
    async with connect("") as websocket:
8
        await websocket.root_subscribe()
9
        first_resp = await websocket.recv()
10
        subscription_id = first_resp.result
11
        async for idx, msg in enumerate(websocket):
12
            print(msg)
13

14
asyncio.run(main())

1
import solana
2
import asyncio
3
from asyncstdlib import enumerate
4
from solana.rpc.websocket_api import connect
5

6
async def main():
7
    async with connect("") as websocket:
8
        await websocket.root_subscribe()
9
        first_resp = await websocket.recv()
10
        subscription_id = first_resp.result
11
        async for idx, msg in enumerate(websocket):
12
            print(msg)
13

14
asyncio.run(main())

1
wscat -c  \ 
2
# wait for connection 
3
{"id":1,"jsonrpc":"2.0","method": "rootSubscribe" }

1
wscat -c  \ 
2
# wait for connection 
3
{"id":1,"jsonrpc":"2.0","method": "rootSubscribe" }

Response

1
{
2
  "jsonrpc": "2.0",
3
  "result": 0,
4
  "id": 1
5
}

1
{
2
  "jsonrpc": "2.0",
3
  "result": 0,
4
  "id": 1
5
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free