Skip to main content

eth_newBlockFilter

Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth_getFilterChanges. This method uses 80 credits from your daily balance.

Expires after 15 minutes of inactivity

Filters that are not polled using eth_getFilterChanges automatically expires after 15 minutes of inactivity. Filter IDs can be polled by any connection using the same API key.

Parameters​

None.

Returns​

filter ID: A hexadecimal denoting the newly created filter ID.

Example​

Replace <YOUR-API-KEY> with an API key from your MetaMask Developer dashboard.

Request​

curl https://optimism-mainnet.infura.io/v3/<YOUR-API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "eth_newBlockFilter", "params": [], "id": 1}'

Response​

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x8144114ddff0b3be57ad6a848ee4fe4a44cdda667055"
}
On this page