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

Parameters

filter ID
string
REQUIRED

The filter ID returned by eth_newFilter or eth_newBlockFilter

Returns

result
array

An array of log objects for a log filter, block hashes for a block filter, or an empty array if no matching events occurred

address
string

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
string

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

blockNumber
string | null

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

transactionHash
string | null

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

transactionIndex
string | null

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

blockHash
string | null

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

logIndex
string | null

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

removed
boolean

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

blockTimestamp
string

Timestamp of the block containing the log, encoded as a hexadecimal quantity

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"address": "0xd0e627cd8e3197503cc1283fdb7f97fb3d6c5d95",
7
"topics": [
8
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
9
"0x0000000000000000000000003af31c44a2419b8356dae9ce0f8526bbe2a6458f",
10
"0x000000000000000000000000e670ffa1d10d0825077afdbbb76fc93dfd10266c",
11
"0x00000000000000000000000000000000000000000000000000000000000002cf"
12
],
13
"data": "0x",
14
"blockNumber": "0x92c210",
15
"transactionHash": "0xb67fd281fe0672a7671db6b3bd41208c2de067887c6c18e813d8f460ecf66b04",
16
"transactionIndex": "0x1",
17
"blockHash": "0x4659abbf3cb14ae45c5db1375d5264ed365fde139763ecb6a3577c60eb0a3799",
18
"blockTimestamp": "0x6ad1095e",
19
"logIndex": "0x0",
20
"removed": false
21
},
22
{
23
"address": "0x0ff8b7afc288ac42f82320f54a49c400f233bf07",
24
"topics": [
25
"0x72d3f914473a393354e6fcd9c3cb7d2eee53924b9b856f9da274e024566292a5"
26
],
27
"data": "0x0000000000000000000000003af31c44a2419b8356dae9ce0f8526bbe2a6458f000000000000000000000000e670ffa1d10d0825077afdbbb76fc93dfd10266c000000000000000000000000d0e627cd8e3197503cc1283fdb7f97fb3d6c5d9500000000000000000000000000000000000000000000000000000000000002cf000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000470de4df82000000000000000000000000000041051f27c609db70af05b7128f15155dc8e49ac7",
28
"blockNumber": "0x92c210",
29
"transactionHash": "0xb67fd281fe0672a7671db6b3bd41208c2de067887c6c18e813d8f460ecf66b04",
30
"transactionIndex": "0x1",
31
"blockHash": "0x4659abbf3cb14ae45c5db1375d5264ed365fde139763ecb6a3577c60eb0a3799",
32
"blockTimestamp": "0x6ad1095e",
33
"logIndex": "0x1",
34
"removed": false
35
}
36
]
37
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"address": "0xd0e627cd8e3197503cc1283fdb7f97fb3d6c5d95",
7
"topics": [
8
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
9
"0x0000000000000000000000003af31c44a2419b8356dae9ce0f8526bbe2a6458f",
10
"0x000000000000000000000000e670ffa1d10d0825077afdbbb76fc93dfd10266c",
11
"0x00000000000000000000000000000000000000000000000000000000000002cf"
12
],
13
"data": "0x",
14
"blockNumber": "0x92c210",
15
"transactionHash": "0xb67fd281fe0672a7671db6b3bd41208c2de067887c6c18e813d8f460ecf66b04",
16
"transactionIndex": "0x1",
17
"blockHash": "0x4659abbf3cb14ae45c5db1375d5264ed365fde139763ecb6a3577c60eb0a3799",
18
"blockTimestamp": "0x6ad1095e",
19
"logIndex": "0x0",
20
"removed": false
21
},
22
{
23
"address": "0x0ff8b7afc288ac42f82320f54a49c400f233bf07",
24
"topics": [
25
"0x72d3f914473a393354e6fcd9c3cb7d2eee53924b9b856f9da274e024566292a5"
26
],
27
"data": "0x0000000000000000000000003af31c44a2419b8356dae9ce0f8526bbe2a6458f000000000000000000000000e670ffa1d10d0825077afdbbb76fc93dfd10266c000000000000000000000000d0e627cd8e3197503cc1283fdb7f97fb3d6c5d9500000000000000000000000000000000000000000000000000000000000002cf000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000470de4df82000000000000000000000000000041051f27c609db70af05b7128f15155dc8e49ac7",
28
"blockNumber": "0x92c210",
29
"transactionHash": "0xb67fd281fe0672a7671db6b3bd41208c2de067887c6c18e813d8f460ecf66b04",
30
"transactionIndex": "0x1",
31
"blockHash": "0x4659abbf3cb14ae45c5db1375d5264ed365fde139763ecb6a3577c60eb0a3799",
32
"blockTimestamp": "0x6ad1095e",
33
"logIndex": "0x1",
34
"removed": false
35
}
36
]
37
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free