Skip to main content

eth_getFilterLogs

Returns an array of all logs matching filter with given filter ID.

Parameters​

A filter object with the following keys and their values:

  • fromBlock: [optional, default: latest] A hexadecimal block number, or latest for the last mined block. The pending option is not currently supported. See the default block parameter.
  • toBlock: [optional, default: latest] A hexadecimal block number, or latest for the last mined block. See the default block parameter.
  • address: [optional] (20 bytes). Contract address or a list of addresses from which logs should originate.
  • topics: [optional] An array of 32 bytes DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with or options.
  • blockHash: [optional] With the addition of EIP-234, blockHash restricts the logs returned to the single block with the 32-byte hash blockHash. Using blockHash is equivalent to fromBlock = toBlock = the block number with hash blockHash. If blockHash is present in the filter criteria, then neither fromBlock nor toBlock are allowed.

Returns​

  • log object array: (array) An array of log objects that match filter. For an array of logs that occurred since the last poll, use eth_getFilterChanges. Log objects contain the following keys and their values:
    • address: 20 bytes. Address from which this log originated.
    • blockHash: 32 bytes. The hash of the block where this log was in. Null when it is a pending log.
    • blockNumber: The block number where this log was in. Null when it is a pending log.
    • data: DATA. Contains the non-indexed arguments of the log.
    • logIndex: A hexadecimal of the log index position in the block. Null when it is a pending log.
    • removed: true when the log was removed, due to a chain reorganization. false if it is a valid log.
    • topics: Array of DATA. An array of 0 to 4 32-bytes DATA of indexed log arguments. In Solidity the first topic is the hash of the signature of the event (for example, Deposit(address,bytes32,uint256)), except when you declared the event with the anonymous specifier.
    • transactionHash: 32 bytes. A hash of the transactions from which this log was created. Null when it is a pending log.
    • transactionIndex: A hexadecimal of the transactions index position from which this log was created. Null when it is a pending log.

Example​

Replace <YOUR-API-KEY> with an API key from your MetaMask Developer dashboard.

Request​

curl https://mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "eth_getFilterLogs", "params": ["0x10ff0bfbedb01f0dbd4106d14eb719ec38b6eb5b821c"], "id": 1}'

Response​

{
  "jsonrpc": "2.0",
  "id": 73,
  "result": [
    {
      "address": "0xb5a5f22694352c15b00323844ad545abb2b11028",
      "blockHash": "0x99e8663c7b6d8bba3c7627a17d774238eae3e793dee30008debb2699666657de",
      "blockNumber": "0x5d12ab",
      "data": "0x0000000000000000000000000000000000000000000000a247d7a2955b61d000",
      "logIndex": "0x0",
      "removed": false,
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000bdc0afe57b8e9468aa95396da2ab2063e595f37e",
        "0x0000000000000000000000007503e090dc2b64a88f034fb45e247cbd82b8741e"
      ],
      "transactionHash": "0xa74c2432c9cf7dbb875a385a2411fd8f13ca9ec12216864b1a1ead3c99de99cd",
      "transactionIndex": "0x3"
    }
  ]
}