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

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.

Returns

result
array

Array of log objects matching the filter.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [{
    "fromBlock": "0x1",
    "toBlock": "latest",
    "address": "0xa0b86a33e6776e1e627e5c82df4c0cf77b8bb0c9"
  }]
}
{
  "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

CodeMessageDescription
-32602Invalid filter parametersThe filter object contains invalid parameters
-32005Limit exceededThe filter matches too many logs
4100Requested method not supportedThe 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.