eth_uninstallFilter

eth_uninstallFilter removes a server-side filter from a Base node by its ID, freeing the resources that filter was holding. It works for every filter type the node tracks — log filters from eth_newFilter, block filters from eth_newBlockFilter, and pending-transaction filters from eth_newPendingTransactionFilter. Base is Coinbase's OP Stack optimistic rollup built on Ethereum with gas paid in ETH, and because its sequencer ships a block roughly every two seconds, active filters accumulate matches quickly; tearing one down once you no longer poll it keeps the node from buffering changes you will never read. Send the call to https://base.therpc.io/YOUR_API_KEY on chain ID 8453 (hex 0x2105).

Use cases

• Clean up a log filter once a Base monitoring session ends — for example after you stop watching Aerodrome pool events — so the node stops buffering changes and releases resources.
• Cancel every active filter on application shutdown, tearing down all open log, block, and pending-transaction filters your Base service created during its run.

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_uninstallFilter",
7    "params": ["0x1"],
8    "id": 1
9  }'

Try it live in the Base playground.

Errors & troubleshooting

Common pitfalls

• A false return is not an error — it usually means the filter was already gone, having expired naturally before you called uninstall. Treat it as "nothing to remove," not a failure.
• Base nodes auto-expire idle filters after roughly five minutes of no polling, so a filter you stopped reading may vanish on its own. Still, calling eth_uninstallFilter explicitly when you are done is the cleaner practice and avoids relying on that timeout.

Supported networks

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

See also

• eth_newFilter
• eth_newBlockFilter
• eth_newPendingTransactionFilter
• eth_getFilterChanges

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_uninstallFilter","params":["0x1"]}'