blockSubscribe

This method is considered unstable and therefore is not supported on our RPC nodes.

blockSubscribe — Subscribe to new blocks (UNSUPPORTED on SVS)

post

wss://public.rpc.solanavibestation.comwss://lite.rpc.solanavibestation.comwss://basic.rpc.solanavibestation.comwss://ultra.rpc.solanavibestation.comwss://elite.rpc.solanavibestation.comwss://epic.rpc.solanavibestation.com

/

Not available on SVS nodes. This method is considered unstable in Agave/Solana and is therefore not enabled on our RPC infrastructure. Calls will be rejected. Use an alternative subscription method or polling-based pattern for this use case. Subscribe to receive notification anytime a new block is confirmed or finalized. Parameters

1. filter (required) — Filter for block subscription (all, or {mentionsAccountOrProgram: }).

2. config (optional) — Optional configuration object. Every field is optional; omit the entire object to use defaults.

Authorizations

AuthHeaderURLParameter

AuthorizationstringOptional

Pass Authorization: <api-key> on each request.

Body

application/json

jsonrpcstring · enumRequired

JSON-RPC protocol version.

Example: 2.0Possible values:

idone ofRequired

Request identifier echoed back in the response.

Example: 1

stringOptional

or

integerOptional

methodstring · enumRequired

Must be blockSubscribe.

Example: blockSubscribePossible values:

Responses

200

Successful blockSubscribe response.

application/json

Base envelope of every JSON-RPC 2.0 response.

jsonrpcstring · enumRequiredExample: 2.0Possible values:

idone ofRequired

Echoed request id.

Example: 1

stringOptional

or

integerOptional

resultinteger · int64Required

Subscription id. Save this value to call the matching unsubscribe method later.

Example: 24040

401

Authentication required or invalid.

application/json

403

Insufficient permissions for the request.

application/json

429

Rate limit exceeded for this tier.

application/json

500

Unexpected server error.

application/json

post/

cURL / websocatPythonJavaScriptRust

# cURL doesn't speak WebSocket — use `websocat` (or `wscat -c`).
# Install:  cargo install websocat   # or  npm install -g wscat
echo '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "blockSubscribe",
  "params": [
    "all",
    {
      "encoding": "json",
      "showRewards": false,
      "transactionDetails": "full",
      "maxSupportedTransactionVersion": 0
    }
  ]
}' | websocat wss://public.rpc.solanavibestation.com

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