API Reference

eth_newFilter

post
https://eth-mainnet.nodereal.io/v1/

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

Path Params
string
required
Defaults to 1659dfb40aa24bbb8153a677b98064d7
Body Params
integer
Defaults to 1
string
Defaults to 2.0
string
enum
Defaults to eth_newFilter
Allowed:
params
array of objects
length between 1 and 1
params
string

Using blockHash is equivalent to fromBlock = toBlock = the block number with hash blockHash. If blockHash is present in the filter criteria, then neither fromBlock nor toBlock are allowed.

address
array of strings

Contract address or a list of addresses from which logs should originate.

address
string
Defaults to latest

String - Either the hex value of a block number OR One of the following block tags:

  • pending - A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool. Intuitively, you can think of these as blocks that have not been mined yet.
  • latest - The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions.
  • safe - The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination. Intuitively, this block is “unlikely” to be re-orged. Only available on Ethereum Mainnet and Goerli.
  • finalized - The most recent crypto-economically secure block, that has been accepted by >2/3 of validators. Cannot be re-orged outside of manual intervention driven by community coordination. Intuitively, this block is very unlikely to be re-orged. Only available on Ethereum Mainnet and Goerli.
  • earliest - The lowest numbered block the client has available. Intuitively, you can think of this as the first block created.
string
Defaults to latest

String - Either the hex value of a block number OR One of the following block tags:

  • pending - A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool. Intuitively, you can think of these as blocks that have not been mined yet.
  • latest - The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions.
  • safe - The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination. Intuitively, this block is “unlikely” to be re-orged. Only available on Ethereum Mainnet and Goerli.
  • finalized - The most recent crypto-economically secure block, that has been accepted by >2/3 of validators. Cannot be re-orged outside of manual intervention driven by community coordination. Intuitively, this block is very unlikely to be re-orged. Only available on Ethereum Mainnet and Goerli.
  • earliest - The lowest numbered block the client has available. Intuitively, you can think of this as the first block created.
topics
array of strings

Array of 32 Bytes DATA topics. Topics are order-dependent. Each topic can also be an array of DATA with "or" options.

topics
Response

Updated 7 months ago

Language
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 7 months ago