blockSubscribe

WebSocket — JSON-RPC Subscribe to receive notifications anytime a new block is confirmed or finalized.
This is an unstable method that requires the validator to run with --rpc-pubsub-enable-block-subscription.

Parameters

params[0]
string | object
required
Filter — either "all" for all transactions, or an object:
  • mentionsAccountOrProgram (string) — only return transactions mentioning this public key
params[1]
object
Configuration object:
  • commitment (string) — finalized or confirmed
  • encoding (string) — json, jsonParsed, base58, base64
  • transactionDetails (string) — full, accounts, signatures, none
  • maxSupportedTransactionVersion (integer)
  • showRewards (boolean)

Request

wscat -c "wss://api.nolimitnodes.com/solana_mainnet?apikey=YOUR_API_KEY"
> {"jsonrpc":"2.0","id":1,"method":"blockSubscribe","params":["all"]}

With Filter

wscat -c "wss://api.nolimitnodes.com/solana_mainnet?apikey=YOUR_API_KEY"
> {"jsonrpc":"2.0","id":1,"method":"blockSubscribe","params":[{"mentionsAccountOrProgram":"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"},{"commitment":"confirmed","encoding":"base64","transactionDetails":"full","showRewards":true,"maxSupportedTransactionVersion":0}]}

Response

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

blockUnsubscribe

WebSocket — JSON-RPC Cancel block notifications.
params[0]
integer
required
Subscription ID returned by blockSubscribe.
wscat -c "wss://api.nolimitnodes.com/solana_mainnet?apikey=YOUR_API_KEY"
> {"jsonrpc":"2.0","id":1,"method":"blockUnsubscribe","params":[0]}
Response
{
  "jsonrpc": "2.0",
  "result": true,
  "id": 1
}

rootSubscribe

WebSocket — JSON-RPC Subscribe to receive notifications anytime a new root is set by the validator. Parameters: None

Request

wscat -c "wss://api.nolimitnodes.com/solana_mainnet?apikey=YOUR_API_KEY"
> {"jsonrpc":"2.0","id":1,"method":"rootSubscribe"}

Response

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

Notification Format

Notifications contain the latest root slot number as an integer.

rootUnsubscribe

WebSocket — JSON-RPC Cancel root notifications.
params[0]
integer
required
Subscription ID returned by rootSubscribe.
wscat -c "wss://api.nolimitnodes.com/solana_mainnet?apikey=YOUR_API_KEY"
> {"jsonrpc":"2.0","id":1,"method":"rootUnsubscribe","params":[0]}
Response
{
  "jsonrpc": "2.0",
  "result": true,
  "id": 1
}

slotSubscribe

WebSocket — JSON-RPC Subscribe to receive notifications whenever a slot is processed by the validator. Parameters: None

Request

wscat -c "wss://api.nolimitnodes.com/solana_mainnet?apikey=YOUR_API_KEY"
> {"jsonrpc":"2.0","id":1,"method":"slotSubscribe"}

Response

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

Notification Format

result
object

slotUnsubscribe

WebSocket — JSON-RPC Cancel slot notifications.
params[0]
integer
required
Subscription ID returned by slotSubscribe.
wscat -c "wss://api.nolimitnodes.com/solana_mainnet?apikey=YOUR_API_KEY"
> {"jsonrpc":"2.0","id":1,"method":"slotUnsubscribe","params":[0]}
Response
{
  "jsonrpc": "2.0",
  "result": true,
  "id": 1
}

slotsUpdatesSubscribe

WebSocket — JSON-RPC Subscribe to receive notifications from the validator on a variety of updates on every slot.
This is an unstable method. The response format may change in future releases.
Parameters: None

Request

wscat -c "wss://api.nolimitnodes.com/solana_mainnet?apikey=YOUR_API_KEY"
> {"jsonrpc":"2.0","id":1,"method":"slotsUpdatesSubscribe"}

Response

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

Notification Format

result
object

slotsUpdatesUnsubscribe

WebSocket — JSON-RPC Cancel slot-update notifications.
params[0]
integer
required
Subscription ID returned by slotsUpdatesSubscribe.
wscat -c "wss://api.nolimitnodes.com/solana_mainnet?apikey=YOUR_API_KEY"
> {"jsonrpc":"2.0","id":1,"method":"slotsUpdatesUnsubscribe","params":[0]}
Response
{
  "jsonrpc": "2.0",
  "result": true,
  "id": 1
}