eth_unsubscribe

eth_unsubscribe cancels an active WebSocket subscription on an Avalanche C-Chain node, identified by the ID that eth_subscribe returned. Once cancelled, the node stops pushing eth_subscription notifications for that stream, so it is how you tear down a newHeads, logs, or pending-transaction feed you no longer need. On the C-Chain — the EVM chain where AVAX pays for gas, secured by Snowman/Avalanche consensus — releasing idle subscriptions keeps a long-lived connection tidy. Issue the call over the same wss:// session opened against https://avalanche.therpc.io/YOUR_API_KEY (chain ID 43114, 0xa86a).

Use cases

• Stop a newHeads subscription when a user navigates away from a live C-Chain view, so the node stops pushing block headers your UI no longer renders.
• Rotate subscriptions cleanly: unsubscribe the existing logs stream before opening a new one with updated address or topic filters, avoiding overlapping notifications.

Parameters

Response

Example request

1curl https://avalanche.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 Avalanche playground.

Errors & troubleshooting

Common pitfalls

• eth_unsubscribe must be called on the same WebSocket connection that created the subscription. A subscription ID from one socket is unknown to another, so a cross-connection call returns "invalid subscription id".
• Closing the WebSocket connection automatically cancels every subscription bound to it, so explicit unsubscribe is optional when you are about to disconnect. It is still good practice for long-lived C-Chain connections where you keep the socket open and only want to drop one stream.

Supported networks

• Mainnet — Chain ID: 43114
• Fuji

See also

• eth_subscribe
• eth_uninstallFilter
• eth_getLogs

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