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

tx_sig

The transaction signature as base-58 encoded string

object

object

The configuration object with the following fields:

commitment

string

All fields are strings.

finalized

the node will query the most recent block confirmed by supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.

confirmed

the node will query the most recent block that has been voted on by supermajority of the cluster.

processed

the node will query its most recent block. Note that the block may not be complete.

Returns

result

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

Notification Format:

result

Error if the transaction failed and null if the transaction succeeded

Request

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

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

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.signature_subscribe('51y9Hf2cFzrUPDH24qvL6b6PtPMDGQSX3WwiHsSvkdfGiFTKdoJwGkvqS3gny6XNPLtUtRwGERAs45639EfR5XfT')
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.signature_subscribe('51y9Hf2cFzrUPDH24qvL6b6PtPMDGQSX3WwiHsSvkdfGiFTKdoJwGkvqS3gny6XNPLtUtRwGERAs45639EfR5XfT')
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":"signatureSubscribe","params":["51y9Hf2cFzrUPDH24qvL6b6PtPMDGQSX3WwiHsSvkdfGiFTKdoJwGkvqS3gny6XNPLtUtRwGERAs45639EfR5XfT"]}

1
wscat -c  \ 
2
# wait for connection 
3
{"id":1,"jsonrpc":"2.0","method":"signatureSubscribe","params":["51y9Hf2cFzrUPDH24qvL6b6PtPMDGQSX3WwiHsSvkdfGiFTKdoJwGkvqS3gny6XNPLtUtRwGERAs45639EfR5XfT"]}

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