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
Jun 30, 2025

Parameters

filter ID
string
REQUIRED

The filter id that is returned from eth_newFilter, eth_newBlockFilter

Returns

array

An array of one of the following, depending on the filter type, or empty if there were no changes since the last poll:

eth_newBlockFilter
array
blockHash
array

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

eth_newBlockFilter
array
address
array

An address from which this log originated

topics
array

An array of zero to four 32 Bytes DATA of indexed log arguments. In Solidity, the first topic is the hash of the signature of the event (e.g. Deposit(address, bytes32, uint256)), except you declare the event with the anonymous specifier

data
array

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

blockNumber
array

The block number where this log was in. null when its a pending log

transactionHash
array

The hash of the transactions this log was created from. null when its a pending log

transactionIndex
array

The integer of the transaction's index position that the log was created from. null when it's a pending log

blockHash
array

The hash of the block where this log was in. null when its a pending log

logIndex
array

The integer of the log index position in the block. null when it's a pending log

removed
array

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