# Ethereum eth_getFilterChanges RPC method

Ethereum API polling method for a filter, which returns an array of logs which occurred since last poll.

Parameters:

Returns:

  • array — an array of one of the following, depending on the filter type, or empty if no changes occurred since the last poll:
    • For filters created with eth_newBlockFilter:
      • blockHash — the 32 bytes hash of a block that meets your filter requirements.
    • For filters created with eth_newPendingTransactionFilter:
      • transactionHash — the 32 bytes hash of a transaction that meets your filter requirements.
    • For filters created with eth_newFilter, logs are objects with the following parameters:
      • removed — the boolean value True if the log was removed due to a chain reorganization. False if it is a valid log.
      • logindex — the integer of the log index position in the block, encoded as hexadecimal. null if pending.
      • transactionindex — the integer of the transactions' index position the log was created from. null if pending.
      • transactionhash — the hash of the transactions the log was created from. null if pending.
      • blockhash — the hash of the block where this log was in. null if pending.
      • blocknumber — the block number where this log was encoded as hexadecimal. null if pending.
      • address — the address from which this log originated.
      • data — contains one or more 32 bytes non-indexed arguments of the log.
      • topics — an array of 0 to 4 32 bytes of indexed log arguments.

Example:

  • web3.js
  • web3.py
  • eth.rb
  • cURL
// Web3.js does not support this feature. See the Web3.js subscriptions page.