# Ethereum eth_getFilterChanges RPC method

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

Parameters:

quantity — 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 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.