> ## Documentation Index
> Fetch the complete documentation index at: https://docs.uniblock.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# eth_newFilter

> Creates a filter object, based on filter options, to notify when the state changes (logs). To check if the state has changed, call eth_getFilterChanges.

### Parameters

**chainId** `string` *required* (default: 1001)

Unique identifier for a blockchain network.

**id** `number` *required* (default: 1)

Request identifier used to match responses.

**jsonrpc** `string` *required* (default: 2.0)

JSON-RPC version.

**method** `string` *required* (default: eth\_newFilter)

JSON-RPC method name.

**params** `object` *required*

Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.

Positional parameters for `eth_newFilter`:

<ul>
  <li>`params[0]`: Filter options used to create a new filter for logs. Topics are order-dependent. Nulls or nested arrays are used to match multiple possibilities.</li>
</ul>

### Returns

**result** `string`

Quantity - The filter ID. Example: `"0x1"`.

```bash Curl theme={null}
curl --request POST \
  --url https://api.uniblock.dev/uni/v1/json-rpc?chainId=1001 \
  --header 'content-type: application/json' \
  --data '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "eth_newFilter",
    "params": [
      {
        "fromBlock": "0x1",
        "toBlock": "0x2",
        "address": "0x8888f1f195afa192cfee860698584c030f4c9db1",
        "topics": [
          "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
          null,
          [
            "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
            "0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"
          ]
        ]
      }
    ]
  }'
```

```json Success theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.