eth_unsubscribe

eth_unsubscribe cancels an active WebSocket subscription on OP Mainnet — the OP Stack rollup that settles to Ethereum L1 and pays gas in ETH — by passing the hex ID that eth_subscribe returned. Once cancelled, the node stops pushing further eth_subscription notifications for that stream, which keeps your connection lean when you no longer need newHeads, logs, or pending-transaction events. Issue the call over the same WebSocket at https://optimism.therpc.io/YOUR_API_KEY (chain ID 10, 0xa). It returns true if the subscription was found and removed, or false if it did not exist.

Use cases

• Stop a newHeads subscription when a user leaves a live OP Mainnet block view, so the node stops streaming updates the UI no longer renders.
• Rotate logs subscriptions by unsubscribing the old ID before opening a new one with updated address or topic filters, avoiding overlapping duplicate streams.

Parameters

Response

Example request

1curl https://optimism.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 Optimism playground.

Errors & troubleshooting

Common pitfalls

• Must be called on the same WebSocket connection that created the subscription; an ID from another connection is unknown to the node and yields an error or false.
• Closing the WebSocket connection automatically cancels every subscription tied to it, so explicit eth_unsubscribe is optional on teardown — but it is still good practice when you keep a long-lived connection open and only want to drop one stream.

Supported networks

• Mainnet — Chain ID: 10
• Sepolia — Chain ID: 11155420

See also

• eth_subscribe
• eth_uninstallFilter
• eth_getLogs

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_unsubscribe","params":[""]}'