Skip to main content

eth_newFilter RPC Method

Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.

Updated on
Apr 29, 2026

To use the eth_newFilter method on the C-Chain, ensure that the end of your URL includes ext/bc/C/rpc.

Parameters

object
object

The transaction response object which contains the following filter information:

fromBlock
string

The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators

toBlock
string

The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators

address
string

The contract address or a list of addresses from which logs should originate

topics
array

An array of DATA topics and also, the topics are order-dependent

Returns

result
string

It returns a filter id to be used when calling eth_getFilterChanges

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": "0xe6b147ce1f04fa734095ba4ce3d17718"
5
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": "0xe6b147ce1f04fa734095ba4ce3d17718"
5
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free