API Reference

eth_getFilterChanges

Returns an array of log objects that have been emitted since the last poll. This method is a polling method for a filter.

📘

Note:

The filter must be created by calling eth_newFilter, eth_newPendingTransactionFilter, or eth_newBlockFilter.

Request Parameters

  • FILTER ID: a hexadecimal string.

Response

An array of log objects, or an empty array if nothing has changed since the last poll.

Result Fields

  • LOG OBJECT ARRAY: an array of log objects, or an empty array if nothing has changed since the last poll.
    For filters created by using eth_newBlockFilter or eth_newPendingTransactionFilter, this method returns a 32-byte hash of the block or the transaction, such as ["0x90d02f7670ffad0c..."].
    For filters created by using eth_newFilter, a returned log object contains the following parameters:
    • removed: returns true if the log was removed due to a chain reorganization. The value is false for a valid log.
    • logIndex: the hexadecimal position of the log index in the block. For a pending log, null is returned.
    • transactionIndex: the hexadecimal number of the transaction index position where the log was created. For a pending log, null is returned.
    • transactionHash: the 32-byte hash of the transaction from which the log was created. For a pending log, null is returned.
    • blockHash: the 32-byte hash of the block where the log is located. For a pending log, null is returned.
    • blockNumber: the number of the block where the log is located. For a pending log, null is returned.
    • address: the 20-byte address from which the log originated.
    • data: contains non-indexed parameters of the log.
    • topics: an array of zero to four 32-byte DATA of indexed log arguments. (In Solidity, the first topic is the hash of the event signature, such as Deposit(address, bytes32, uint256), unless you have declared the event with the anonymous specifier.)

Examples

Example Responses
{
	"result": ["0x90d02f7670ffad0c7167de3e0ad3c57cd0781707adc418f9c3f8efe49564b144", "0xeb1f6c7d686163dd7239271f2d30b767dd1343f8f0c247b92c61045fc9d7172c", "0xc3127ad348fede54644be15e6a3f14c2431cf4c86e2c6efe9e6e02c7a3ec6340", "0xea23065aa512725ac00570f62844f793f84a727a88120f93481363638fee6f80", "0xde597131b4ff075613a6c4a5b85b9a48b7a15d6df324d939e35374c97c775d4a"],
	"id": 1,
	"jsonrpc": "2.0"
}
{
    "jsonrpc": "2.0",
    "id": 1,
    "result": [{
        "address": "0xb5a5f22694352c15b00323844ad545abb2b11028",
        "blockHash": "0x99e8663c7b6d8bba3c7627a17d774238eae3e793dee30008debb2699666657de",
        "blockNumber": "0x5d12ab",
        "data": "0x0000000000000000000000000000000000000000000000a247d7a2955b61d000",
        "logIndex": "0x0",
        "removed": false,
        "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x000000000000000000000000bdc0afe57b8e9468aa95396da2ab2063e595f37e", "0x0000000000000000000000007503e090dc2b64a88f034fb45e247cbd82b8741e"],
        "transactionHash": "0xa74c2432c9cf7dbb875a385a2411fd8f13ca9ec12216864b1a1ead3c99de99cd",
        "transactionIndex": "0x3"
    }, {
        "address": "0xe38165c9f6deb144afc9c32c206b024817e1496d",
        "blockHash": "0x99e8663c7b6d8bba3c7627a17d774238eae3e793dee30008debb2699666657de",
        "blockNumber": "0x5d12ab",
        "data": "0x0000000000000000000000000000000000000000000000000000000025c6b720",
        "logIndex": "0x3",
        "removed": false,
        "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef", "0x00000000000000000000000080e73e47173b2d00b531bf83bc39e710157125c3", "0x0000000000000000000000008f6cc93795969e5bbbf07c66dfee7d41ad24f1ef"],
        "transactionHash": "0x9e8f1cb1facb9a11a1cf947634053a0b2d557399f926b12127aa10497a2f0153",
        "transactionIndex": "0x5"
    }]
}
Language
Click Try It! to start a request and see the response here!