Powered By GitBook
eth_newFilter
Creates a filter object, based on filter options, to notify when the state changes (logs).
Unlike eth_newBlockFilterwhich notifies you of all new blocks, you can pass in filter options to track new logs matching the topics specified.
To check if the state has changed, call eth_getFilterChanges.​

A note on 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)”

Parameters

    Object - The filter options:
      1.
      fromBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" for the last mined block or "pending", "earliest" for not yet mined transactions.
      2.
      toBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" for the last mined block or "pending", "earliest" for not yet mined transactions.
      3.
      address: DATA|Array, 20 Bytes - (optional) Contract address or a list of addresses from which logs should originate.
      4.
      topics: Array of DATA, - (optional) Array of 32 Bytes DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with β€œor” options.
1
params: [{
2
"fromBlock": "0x1",
3
"toBlock": "0x2",
4
"address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
5
"topics": ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", null, ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"]]
6
}]
Copied!

Returns

QUANTITY - A filter id.

​Example​

Request
Curl
Postman
1
curl https://eth-mainnet.alchemyapi.io/v2/your-api-key \
2
-X POST \
3
-H "Content-Type: application/json" \
4
-d '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"fromBlock": "0x1","toBlock": "0x2","address": "0x8888f1f195afa192cfee860698584c030f4c9db1","topics": ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", null, ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"]]}],"id":0}'
Copied!
1
URL: https://eth-mainnet.alchemyapi.io/v2/your-api-key
2
RequestType: POST
3
Body:
4
{
5
"jsonrpc":"2.0",
6
"method":"eth_newFilter",
7
"params":[{"fromBlock": "0x1","toBlock": "0x2","address": "0x8888f1f195afa192cfee860698584c030f4c9db1","topics": ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", null, ["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b", "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"]]}],
8
"id":0
9
}
Copied!
Result
1
{
2
"jsonrpc": "2.0",
3
"id": 0,
4
"result": "0xdcc9a819f80efa9e1d215a9d41b2d22e"
5
}
Copied!

​

Last modified 2mo ago
Copy link