Skip to main content
Ethereum API
Multichain API

eth_getLogs

Summary: Returns an array of all logs matching the specified filter.

Parameters

Filter
object

filter

fromBlock
string

from block

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

toBlock
string

to block

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

address
oneOf

Address(es)

Any Address
null

Any Address

hex encoded address
string

hex encoded address

Pattern: ^0x[0-9a-fA-F]{40}$

Addresses
array

Addresses

hex encoded address
string

hex encoded address

Pattern: ^0x[0-9a-fA-F]{40}$

topics
oneOf

Topics

Any Topic Match
null

Any Topic Match

Specified Filter Topics
array

Specified Filter Topics

Filter Topic List Entry
oneOf

Filter Topic List Entry

32 hex encoded bytes
string

32 hex encoded bytes

Pattern: ^0x[0-9a-f]{64}$

Multiple Topic Match
array

Multiple Topic Match

32 hex encoded bytes
string

32 hex encoded bytes

Pattern: ^0x[0-9a-f]{64}$

Returns

Log objects
oneOf

Filter results

new block or transaction hashes
array

new block or transaction hashes

32 byte hex value
string

32 byte hex value

Pattern: ^0x[0-9a-f]{64}$

new logs
array

new logs

log
object
required

log

removed
boolean

removed

logIndex
string

log index

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

transactionIndex
string

transaction index

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

transactionHash
string

32 byte hex value

Pattern: ^0x[0-9a-f]{64}$

blockHash
string

32 byte hex value

Pattern: ^0x[0-9a-f]{64}$

blockNumber
string

block number

Pattern: ^0x([1-9a-f]+[0-9a-f]*|0)$

address
string

hex encoded address

Pattern: ^0x[0-9a-fA-F]{40}$

data
string

data

Pattern: ^0x[0-9a-f]*$

topics
array

topics

32 hex encoded bytes
string

32 hex encoded bytes

Pattern: ^0x[0-9a-f]{64}$

Customize request
Parameter
Value
string
string
0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
oneOf
  • Any Address
  • hex encoded address
  • Addresses
oneOf
  • Any Topic Match
  • Specified Filter Topics

Connect your MetaMask wallet to run requests successfully.

Request

await window.ethereum.request({
 "method": "eth_getLogs",
 "params": [
  {
    fromBlock: "0x137d3c2",
    toBlock: "0x137d3c3",
    address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    topics: []
  }
],
});

Example response

[
  {
    "logIndex": "0x0",
    "removed": false,
    "blockNumber": "0x233",
    "blockHash": "0xfc139f5e2edee9e9c888d8df9a2d2226133a9bd87c88ccbd9c930d3d4c9f9ef5",
    "transactionHash": "0x66e7a140c8fa27fe98fde923defea7562c3ca2d6bb89798aabec65782c08f63d",
    "transactionIndex": "0x0",
    "address": "0x42699a7612a82f1d9c36148af9c77354759b210b",
    "data": "0x0000000000000000000000000000000000000000000000000000000000000004",
    "topics": [
      "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3"
    ]
  },
  {
    "logIndex": "0x0",
    "removed": false,
    "blockNumber": "0x238",
    "blockHash": "0x98b0ec0f9fea0018a644959accbe69cd046a8582e89402e1ab0ada91cad644ed",
    "transactionHash": "0xdb17aa1c2ce609132f599155d384c0bc5334c988a6c368056d7e167e23eee058",
    "transactionIndex": "0x0",
    "address": "0x42699a7612a82f1d9c36148af9c77354759b210b",
    "data": "0x0000000000000000000000000000000000000000000000000000000000000007",
    "topics": [
      "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3"
    ]
  }
]