eth_uninstallFilter

eth_uninstallFilter removes a server-side filter from an Avalanche C-Chain node by its ID, freeing the resources the node held to track it. It works for any filter type created with eth_newFilter, eth_newBlockFilter, or eth_newPendingTransactionFilter. Because each open filter keeps state on the node — buffering matches between your eth_getFilterChanges polls — uninstalling filters you no longer need keeps your usage lean on a chain as active as the C-Chain, where AVAX-settled DeFi traffic generates a steady stream of events. Send the request to https://avalanche.therpc.io/YOUR_API_KEY (chain ID 43114, 0xa86a) with the filter ID you want to drop.

Use cases

• Clean up a log filter once a C-Chain monitoring session ends — for example after you stop tracking a Trader Joe pair's events — to release the resources the node was holding.
• Cancel every active filter on application shutdown so your service exits without leaving dangling filters that would otherwise linger until they auto-expire.

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

Try it live in the Avalanche playground.

Errors & troubleshooting

Common pitfalls

• A false return is not an error. It simply means the C-Chain node could not find that filter ID — typically because the filter already expired or was never created. Treat it as a no-op rather than a failure.
• Idle filters auto-expire after roughly five minutes of inactivity, so a filter you forget about will eventually be reclaimed. Even so, explicit cleanup with eth_uninstallFilter is better practice than relying on timeout, especially for short-lived polling jobs.

Supported networks

• Mainnet — Chain ID: 43114
• Fuji

See also

• eth_newFilter
• eth_newBlockFilter
• eth_newPendingTransactionFilter
• eth_getFilterChanges

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