eth_unsubscribe

eth_unsubscribe cancels an active WebSocket subscription on a Base node by passing the hex ID that eth_subscribe returned, after which the node stops pushing further notifications for that stream. Base is Coinbase's OP Stack optimistic rollup that settles to Ethereum and uses ETH for gas, and with the sequencer producing a block about every two seconds an unused newHeads or logs subscription keeps firing several events per second — so closing it promptly stops needless traffic over your socket. Call it on the same WebSocket connection at https://base.therpc.io/YOUR_API_KEY against chain ID 8453 (hex 0x2105).

Use cases

• Stop a newHeads subscription when a user navigates away from a live Base view, so the node stops pushing ~2-second block headers your UI no longer renders.
• Rotate subscriptions cleanly by unsubscribing the old logs stream before opening a new one with updated address/topics filters — for instance when switching from watching one Base contract to another.

Parameters

Response

Example request

1curl https://base.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 Base playground.

Errors & troubleshooting

Common pitfalls

• eth_unsubscribe must be called on the same WebSocket connection that created the subscription. An ID from one socket cannot be cancelled from another, and trying returns an "invalid subscription id" error.
• Closing the WebSocket connection to the Base node automatically cancels every subscription it carried, so explicit unsubscribe is optional when you are tearing down the socket — but it remains good practice when you want to drop one stream while keeping the connection open.

Supported networks

• Mainnet — Chain ID: 8453
• Sepolia — Chain ID: 84532

See also

• eth_subscribe
• eth_uninstallFilter
• eth_getLogs

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