Skip to main content

eth_getFilterLogs

POST
Returns all event logs matching the conditions of the filter identified by the given ID.

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

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

At query time the filter's block range is rechecked. By default the range must not exceed 5,000 blocks,

and this limit is configured by the node's node.jsonrpc.maxBlockRange setting.

param[0]
filterIdstringrequired
The ID of the filter to query.
Responses
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_getFilterLogs",
    "params": [
      "0x2bab51aee6345d2748e0a4a3f4569d80"
    ]
  }'