Skip to main content

eth_getFilterChanges

POST
Polls a filter and returns the changes that occurred since the last poll.A filter created with eth_newFilter returns an array of logs, while one created with eth_newBlockFilter returns an array of block hashes.

📘 On GreatVoyage-v4.8.2 and later, each log includes blockTimestamp.

On gateways that have not been upgraded yet, this field may be omitted.

param[0]
filterIdstringrequired
The ID of the filter to query.
Responses
resultoneOf
The return shape depends on the filter type.
  • A filter created with eth_newFilter: an array of event logs
  • A filter created with eth_newBlockFilter: an array of block hashes
The list of event logs.
addressstring
The address of the contract that emitted the log.
topicsarray
The list of log topics. The first entry is the event signature hash.
datastring
The ABI-encoded data for the non-indexed event arguments.
blockNumberstring
The number of the block containing the log.
blockHashstring
The hash of the block containing the log.
blockTimestampstring
The creation time of the block containing the log, in UNIX epoch seconds, hex-encoded.It is returned on GreatVoyage-v4.8.2 and later, and may be omitted on gateways that have not been upgraded yet.
transactionHashstring
The hash of the transaction that emitted the log.
transactionIndexstring
The transaction index within the block.
logIndexstring
The log index within the block.
removedboolean
Whether the log was removed by a chain reorganization.
codestringrequired
Code identifying the cause of the failed request.
messagestringrequired
Detailed message including the name and value of the invalid parameter.
{
  "code": "ERROR_CODE",
  "message": "Unauthorized"
}
cURL
curl -X POST 'https://tron-mainnet.nodit.io' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getFilterChanges",
    "params": [
      "0x2bab51aee6345d2748e0a4a3f4569d80"
    ]
  }'