Skip to main content

eth_getFilterChanges RPC Method

Polling method for a filter, which returns an array of events that have occurred since the last poll.

Updated on
Jul 10, 2024

Parameters

filter ID
string
REQUIRED

The filter id that is returned from eth_newFilter, eth_newBlockFilter

Returns

array
array

An array of block hashes (eth_newBlockFilter), log objects (eth_newFilter), or empty if there were no changes since the last poll:

eth_newBlockFilter
object
blockHash
string

The 32 byte hash of a block that meets your filter requirements

eth_newFilter
object
address
string

An address from which this log originated

topics
array

An array of zero to four 32 Bytes DATA of indexed log arguments

data
string

It contains one or more 32 Bytes non-indexed arguments of the log

blockNumber
string

The block number where this log was in

transactionHash
string

The hash of the transactions this log was created from

transactionIndex
string

The integer of the transaction's index position that the log was created from

blockHash
string

The hash of the block where this log was in

blockTimestamp
string

The timestamp of the block containing this log, encoded as a hexadecimal value

logIndex
string

The integer of the log index position in the block

removed
boolean

It is true when the log was removed due to a chain reorganization, and false if it's a valid log

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free