eth_unsubscribe

eth_unsubscribe cancels an active WebSocket subscription on Arbitrum One (chain ID 42161) by the ID that eth_subscribe returned, stopping the node from pushing any further notifications for that stream. Arbitrum One is the Optimistic Rollup that settles to Ethereum and pays gas in ETH, and its sequencer streams blocks sub-second, so an unused newHeads or logs subscription keeps delivering a steady flow of messages until you tear it down. Send eth_unsubscribe over the same WebSocket connection you opened against wss://arbitrum.therpc.io/YOUR_API_KEY (the WebSocket form of https://arbitrum.therpc.io/YOUR_API_KEY); the node returns true when it finds and removes the subscription, or false when no such subscription exists.

Use cases

• Stop a newHeads subscription when a user navigates away from a live Arbitrum One view, so your app stops processing block notifications it no longer displays.
• Rotate subscriptions cleanly: unsubscribe the existing logs stream before opening a new one with updated address/topics filters — for example when switching from monitoring a Camelot pool to an Aave market — so you never run two overlapping streams at once.

Parameters

Response

Example request

1curl https://arbitrum.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 Arbitrum One playground.

Errors & troubleshooting

Common pitfalls

• It must be called on the same WebSocket connection that created the subscription. A subscription ID is bound to its connection, so trying to cancel it from a different socket fails with an invalid-subscription-id error.
• Closing the WebSocket connection automatically cancels every subscription tied to it, so explicit unsubscribe is optional when you are about to disconnect. It is still good practice to unsubscribe streams you no longer need on a long-lived Arbitrum One connection, rather than leaving them running until the socket closes.

Supported networks

• Mainnet — Chain ID: 42161
• Sepolia — Chain ID: 421614

See also

• eth_subscribe
• eth_uninstallFilter
• eth_getLogs

1curl https://arbitrum.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":[""]}'