> For the complete documentation index, see [llms.txt](https://aarmaproject.gitbook.io/aarmachain-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aarmaproject.gitbook.io/aarmachain-documentation/network-reference/apis/filter-methods/newblockfilter.md).

# newBlockFilter

Creates a filter in the node, to notify when a new block arrives. To check if the state has changed, call eth\_getFilterChanges.

Filter IDs will be valid for up to fifteen minutes, and can polled by any connection using the same v3 project ID.

**EXAMPLE**

```
Explain## JSON-RPC over HTTPS POST
curl https://mainet.rpc.aarmascan.com
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":1}'

## JSON-RPC over WSS
wscat -c ws://mainet.rpc.aarmascan.com
>{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":1}
```

**RESPONSE**

**RESULT FIELDS**

* `FILTER ID` - A string denoting the newly created filter ID

**BODY**

```
Explain{
    "jsonrpc":"2.0",
    "id":1,
    "result":"0x81440bfbd6138ec9fe6d6ec4398b0b4879fb182f3cd8"
}
```