wscat -c wss://mainnet.solana.validationcloud.io/v1/<YOUR_API_KEY_HERE>
# wait for connection
{"id":1,"jsonrpc":"2.0","method":"blockSubscribe","params":["all"]}
Subscribe to receive a notification anytime a new block is Confirmed or Finalized.
This method will use 20 Compute Units.
filters string. The filter criteria for the logs to receive results by account type. Currently it supports the following params:
all string. Includes all transactions in a block.
object object. An 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 optional. 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 confirmed by the supermajority of the cluster as having reached maximum lockout, meaning the cluster has recognized this block as finalized.
confirmed string. The node will query the most recent block that has been voted on by the supermajority of the cluster.
processed string. The node will query its most recent block. Note that the block may not be complete.
transactionDetails string. The level of transaction detail to return, either 'full', 'signatures', or 'none'.
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.
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.
Unsubscribe from block notifications.
This method will use 20 .
subscriptionID integer Required. The subscription id to cancel, ensuring it matches the previously generated subscription ID from the 'blockSubscribe' method.
result boolean. The result will be a boolean value with unsubscribed success message.
Subscribe to receive a notification anytime a new block is Confirmed or Finalized.
This method will use 20 .
None.
result integer The subscription id (needed to unsubscribe).
slotsUpdatesNotification object. The notification object with the following fields:
parent integer The parent slot.
slot integer The newly updated slot.
timestamp integer The Unix timestamp of the update.
type string The update type, which may be one of the following: 'firstShredReceived', 'completed', 'createdBank', 'frozen', 'dead', 'optimisticConfirmation' or 'root'.
Unsubscribe from slot-update notifications.
This method will use 20 Compute Units.
subscriptionID integer Required. The subscription id to cancel, ensuring it matches the previously generated subscription ID from the 'slotsUpdatesSubscribe' method.
result boolean. The result will be a boolean value with unsubscribed success message.