eth_newFilter

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Parameters

OBJECT - The filter object

Object NameRequiredTypeDetail
address❌String/ArrayAddress or a list of addresses from which logs should originate.
fromBlock❌StringA hex code of an integer that represents the block number, or "latest" for the last mined block. "pending", "earliest" for not yet mined transactions.
toBlock❌StringA hex code of an integer that represents the block number, or "latest" for the last mined block. "pending", "earliest" for not yet mined transactions.
topics❌ArrayArray of 32 Bytes DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.
"params": [
  {
    "fromBlock": "0x1",
    "toBlock": "0x2",
    "address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
    "topics": [
      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", 
      null, 
      [
        "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", 
        "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
      ]
    ]
  }  
]
📘

Specifying topic filters:

Topics are order-dependent. A transaction with a log with topics [A, B] will be matched by the following topic filters:

  • [] “anything”
  • [A] “A in first position (and anything after)”
  • [null, B] “anything in first position AND B in second position (and anything after)”
  • [A, B] “A in first position AND B in second position (and anything after)”
  • [[A, B], [A, B]] “(A OR B) in first position AND (A OR B) in second position (and anything after)”

Result

A hex code of an integer that represents the newly created filter ID.

Example

Request

curl <your-endpoint> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"fromBlock": "0x1","toBlock": "0x2","address": "0x8888f1f195afa192cfee860698584c030f4c9db1","topics": ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", null, ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"]]}],"id":0}'

Return

{
    "id": 0,
    "jsonrpc": "2.0",
    "result": "0x12bf38f0a996df1bb6604e1055470420"
}
Path Params
string
required
Defaults to c94411509d724306b407dbfa6521dac2
Body Params
string
Defaults to {"jsonrpc":"2.0","method":"web3_sha3","params":["0x67656c6c6f20776f726c64"],"id":1}
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json