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

Parameters

Params - a string array containing (required):
  • Object - The filter options:
    • fromBlock(hex string|string, optional). QUANTITY|TAG - integer block number, or "latest" for the last mined block or "pending", "earliest" for not yet mined transactions.
    • toBlock(hex string|string, optional). QUANTITY|TAG - integer block number, or "latest" for the last mined block or "pending", "earliest" for not yet mined transactions.
    • address(hex string, optional). DATA|Array, 20 Bytes - contract address or a list of addresses from which logs should originate.
    • topics(array of hex string, optional). Array of DATA - array of 32 Bytes DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with “or” options.

Returns

QUANTITY(hex string) - a filter id.

Example

Request

curl https://blockvision.org/v1/<your api key> \
-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
}'

Response

{
"jsonrpc": "2.0",
"id": 0,
"result": "0xdcc9a819f80efa9e1d215a9d41b2d22e"
}
Copy link
Outline
Parameters
Returns
Example
Request
Response