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
Oct 15, 2026

Parameters

object
object

The log filter options

fromBlock
string
REQUIRED

A block number encoded as hexadecimal, or a block tag: earliest, latest, pending, safe, or finalized.

toBlock
string
REQUIRED

A block number encoded as hexadecimal, or a block tag: earliest, latest, pending, safe, or finalized.

address
string

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