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
REQUIRED
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
type
The type of change encoded in hexadecimal format
nonce
The transaction nonce encoded in hexadecimal format
gasPrice
The gas price provided by the sender in Wei, encoded as hexadecimal
maxPriorityFeePerGas
The maximum priority gas fee set in the transaction
maxFeePerGas
The maximum fee per gas set in the transaction
gas
The gas provided by the sender, encoded as hexadecimal
value
The value transferred in Wei, encoded as hexadecimal
input
The data sent along with the transaction
v
The ECDSA recovery id encoded as hexadecimal
r
The ECDSA signature r
s
The ECDSA signature s
to
The address of the receiver. Null when it's a contract creation
hash
The 32 byte hash of a transaction that meets your filter requirements
eth_newBlockFilter
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.bsc.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