Skip to main content
Ethereum API
Multichain API

eth_newFilter

Summary: Creates a filter object, based on filter options, to notify when the state changes (logs).

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

Filter identifier
string

hex encoded unsigned integer

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

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_newFilter",
 "params": [
  {
    fromBlock: "0x137d3c2",
    toBlock: "0x137d3c3",
    address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    topics: []
  }
],
});

Example response

"0x01"