eth_unsubscribe

eth_unsubscribe cancels an active WebSocket subscription on a Polygon PoS node by its subscription ID — the hex value returned by eth_subscribe — and stops the node from pushing further eth_subscription notifications for that stream. It is the counterpart to eth_subscribe: when your client no longer needs new Polygon block headers, contract logs, or pending MATIC transactions, this releases the stream cleanly. Issue the call over the same WebSocket connection to the Polygon mainnet endpoint at https://polygon.therpc.io/YOUR_API_KEY (chain ID 137, 0x89).

Use cases

• Stop a newHeads subscription when a user navigates away from a live Polygon block view, so the node stops pushing ~2-second block updates you no longer render.
• Rotate logs subscriptions by unsubscribing the old one before creating a new one with updated filter params — for example switching from QuickSwap pool events to USDT Transfer events without leaking the previous stream.

Parameters

Response

Example request

1curl https://polygon.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 Polygon playground.

Errors & troubleshooting

Common pitfalls

• eth_unsubscribe must be called on the same WebSocket connection that created the subscription. A subscription ID from one connection cannot be cancelled from another, and doing so returns an invalid-subscription error.
• Closing the WebSocket connection automatically cancels all of its subscriptions, so explicit unsubscribe is optional — but it is still good practice to free Polygon node resources promptly when you keep a long-lived connection open for other streams.

Supported networks

• Mainnet — Chain ID: 137
• Amoy — Chain ID: 80002

See also

• eth_subscribe
• eth_uninstallFilter
• eth_getLogs

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