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
Nov 2, 2023

eth_getFilterChanges RPC Method

Parameters

filter ID
string
The filter id that is returned from eth_newFilter, eth_newBlockFilter or eth_newPendingTransactionFilter

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
blockHash
The 32 byte hash of a block that meets your filter requirements
eth_newPendingTransactionFilter
transactionHash
The 32 byte hash of a transaction that meets your filter requirements
eth_newFilter
The 32 byte hash of a transaction that meets your filter requirements
address
An address from which this log originated
topics
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
It contains one or more 32 Bytes non-indexed arguments of the log
blockNumber
The block number where this log was in. null when its a pending log
transactionHash
The hash of the transactions this log was created from. null when its a pending log
transactionIndex
The integer of the transaction's index position that the log was created from. null when it's a pending log
blockHash
The hash of the block where this log was in. null when its a pending log
logIndex
The integer of the log index position in the block. null when it's a pending log
removed
It is true when the log was removed due to a chain reorganization, and false if it's a valid log
Request
1
curl https://docs-demo.xdai.quiknode.pro/ \
2
-X POST \
3
-H "Content-Type: application/json" \
4
--data '{"method":"eth_getFilterChanges","params":["YOUR_FILTER_ID"],"id":1,"jsonrpc":"2.0"}'
5
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free