blockUnsubscribe

blockUnsubscribe tears down one block stream opened with blockSubscribe on the same WebSocket connection. Pass the integer subscription id from the subscribe ack; the server replies result: true and stops pushing blockNotification frames for that id, while the socket and all other subscriptions on it stay live.

Of all the Pub/Sub families, block streams are the ones most worth unsubscribing promptly. A full-detail blockSubscribe on "all" can move multiple megabytes per second; even a filtered stream carries whole transaction payloads. Leaving one running after its consumer is gone wastes client bandwidth, server egress, and parser CPU in a way an idle account watch never does. Typical teardown moments: an indexer completed its real-time phase and is handing off to batch backfill via getBlocks; you are reconfiguring the stream — filter and config are fixed at subscribe time, so switching from transactionDetails: "full" to "signatures", or changing the mentionsAccountOrProgram target, means opening the new subscription first and then unsubscribing the old id (make-before-break, de-duplicating overlapping slots); or an analytics job simply reached the end of its sampling window.

Standard lifecycle rules apply. Ids are valid only within the WebSocket session that created them — after a reconnect the subscription is already gone, so an unsubscribe with a stale id returns -32602 (invalid subscription id), the same error you get for a double unsubscribe. Because block frames are large, one may already be buffered when your unsubscribe lands: expect a final notification or two after the request and drop frames whose params.subscription you no longer route. Closing the socket entirely releases every subscription at once, so shutdown code does not need to unsubscribe block streams individually — though on shared long-lived connections, doing it explicitly keeps the remaining traffic clean.

Positional params array: [subscriptionId].

Response fields

• Heavy stream — drop it early: block subscriptions are the most expensive to leave dangling; unsubscribe the moment the consumer stops.
• Reconfigure = resubscribe: filter and config can't be changed in place; ack the replacement before dropping the old id.
• Buffered frames: large block notifications may trail the ack briefly.
• Related methods: blockSubscribe.