eth_unsubscribe

On BNB Smart Chain, the BNB-settled network with three-second blocks, streaming clients open live feeds through eth_subscribe over a WebSocket connection. eth_unsubscribe closes one of those feeds. Give it the subscription ID that eth_subscribe previously returned and the node stops pushing notifications for it, whether that feed was a newHeads stream of incoming blocks or a logs stream of BEP-20 events. The method is WebSocket-only and means nothing over plain HTTP. Open the socket at https://bsc.therpc.io/YOUR_API_KEY on chain ID 56, and the call replies with a boolean telling you whether the subscription existed and was cancelled.

Use cases

Halt a newHeads block feed the instant a user leaves a live BSC explorer view, so the socket stops delivering updates nobody is watching.
Rotate a logs subscription by cancelling the stale ID first, then opening a fresh one with revised address or topic filters.

Parameters

#	Name	Type	Required	Description
1	`subscriptionId`	string	Yes	The hex subscription ID returned by eth_subscribe.

Response

Type	Description
boolean	`true` if the subscription was found and cancelled. `false` if it did not exist.

Example request

1curl https://bsc.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_unsubscribe",
7    "params": ["0x1"],
8    "id": 1
9  }'

Try it live in the BNB Smart Chain playground.

Errors & troubleshooting

Code	Message	Cause
`-32602`	`invalid subscription id`	The subscription ID is malformed or belongs to a different connection.
`-32000`	`subscription not found`	The subscription was already cancelled or never existed.

Common pitfalls

The cancellation must travel over the exact same WebSocket connection that opened the subscription; an ID issued on one socket is invalid on any other.
Dropping the WebSocket connection altogether discards every subscription tied to it, so an explicit unsubscribe is optional in that case — though calling it deliberately keeps long-lived sockets tidy.

Supported networks

Mainnet — Chain ID: 56
Testnet — Chain ID: 97