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.

Valid for fifteen minutes

Filter IDs will be valid for up to fifteen minutes, and can polled by any connection using the same YOUR-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 Infura dashboard.

Request​

curl https://base-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"
}