eth_getLogs

Get an array of all logs matching a given filter object

Defined in the Ethereum JSON-RPC Specification

Returns an array of all logs matching a given filter object.

Parameters

filterObject · object · required

The filter options object.

Show Filter object properties

fromBlock · string

Integer block number, or “latest” for the last mined block or “pending”, “earliest” for not yet mined transactions.

toBlock · string

Integer block number, or “latest” for the last mined block or “pending”, “earliest” for not yet mined transactions.

address · string | array

Contract address or a list of addresses from which logs should originate.

topics · array

Array of 32 Bytes DATA topics. Topics are order-dependent.

blockhash · string

Using blockHash is equivalent to fromBlock = toBlock = the block number with hash blockHash.

Returns

result · array

Array of log objects matching the filter.

Show Log object properties

removed · boolean

True when the log was removed, due to a chain reorganization. False if it’s a valid log.

logIndex · string

Integer of the log index position in the block. null when its pending log.

transactionIndex · string

Integer of the transaction index position log was created from. null when its pending log.

transactionHash · string

Hash of the transaction this log was created from. null when its pending log.

blockHash · string

Hash of the block where this log was in. null when its pending.

blockNumber · string

The block number where this log was in. null when its pending.

address · string

Address from which this log originated.

data · string

Contains the non-indexed parameters of the log.

topics · array

Array of 0 to 4 32 Bytes DATA of indexed log arguments.

Basic Filter

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [{
    "fromBlock": "0x1",
    "toBlock": "latest",
    "address": "0xa0b86a33e6776e1e627e5c82df4c0cf77b8bb0c9"
  }]
}

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [{
    "fromBlock": "0x1",
    "toBlock": "latest",
    "topics": [
      "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
    ]
  }]
}

Success Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "removed": false,
      "logIndex": "0x1",
      "transactionIndex": "0x0",
      "transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
      "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
      "blockNumber": "0x1b4",
      "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
      "data": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "topics": [
        "0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"
      ]
    }
  ]
}

Error Handling

Code	Message	Description
-32602	Invalid filter parameters	The filter object contains invalid parameters
-32005	Limit exceeded	The filter matches too many logs
4100	Requested method not supported	The method is not supported by the wallet

Large filter ranges may exceed provider limits. Consider using smaller block ranges for better performance.

Topics are order-dependent. Use null as a wildcard for any topic position.