As of July 1, 2026, this WebSocket method is billed based on metered data usage: 0.1 MB = 15 API credits. Due to the large size of block data (~4 MB per block = ~600 API credits), consider using Quicknode Streams or Solana gRPC for more cost-effective full-block data access. Learn more about WebSocket billing.

Parameters

filter

string

The filter criteria for the logs to receive results by account type. Currently it supports the following params:

string

string

The string 'all' which includes all transactions in a block

object

object

A JSON object with the following field:

mentionsAccountOrProgram

string

Only retrieve transactions that reference the specified public key as a base-58 encoded string. If a block contains no such references, no notifications will be generated

object

object

(Optional) A configuration object containing the following fields:

commitment

string

The level of commitment required for the query. The options include:

finalized

string

The node will query the most recent block the cluster has recognized as finalized

confirmed

string

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

transactionDetails

string

(Default: full) The level of transaction detail to return, either 'full', 'accounts', 'signatures', or 'none'

maxSupportedTransactionVersion

integer

The maximum transaction version to return, as a JSON integer. Set it to 1 to receive legacy, version 0, and version 1 transactions

showRewards

boolean

Indicated whether to populate the 'rewards' array

encoding

string

The encoding format for account data. It can be one of base58 (slow), base64, base64+zstd or jsonParsed

Returns

result

integer

The subscription id

blockNotification

object

The notification object with the following fields:

slot

integer

The corresponding slot

err

object

Error if something went wrong publishing the notification otherwise null

block

object

A block object as seen in the getBlock RPC HTTP method

Request

1
wscat -c  \ 
2
# wait for connection 
3
{"id":1,"jsonrpc":"2.0","method":"blockSubscribe","params":["all",{"commitment":"finalized","encoding":"json","transactionDetails":"full","maxSupportedTransactionVersion":1}]}

1
wscat -c  \ 
2
# wait for connection 
3
{"id":1,"jsonrpc":"2.0","method":"blockSubscribe","params":["all",{"commitment":"finalized","encoding":"json","transactionDetails":"full","maxSupportedTransactionVersion":1}]}

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