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
Mar 18, 2026

Parameters

object
object

The transaction response object which contains the following filter information:

fromBlock
string
REQUIRED

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
REQUIRED

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
REQUIRED

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

topics
string

An array of DATA topics and also, the topics are order-dependent. Visit here to learn more about topics

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": "0x61160306463b897e8f2e691de6f07e07"
5
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": "0x61160306463b897e8f2e691de6f07e07"
5
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free