> ## 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

<ParamField query="chainId" type="string" default="11011" required>
  Unique identifier for a blockchain network.
</ParamField>

<ParamField body="id" type="number" default={1} required>
  Request identifier used to match responses.
</ParamField>

<ParamField body="jsonrpc" type="string" default="2.0" required>
  JSON-RPC version.
</ParamField>

<ParamField body="method" type="string" default="eth_newFilter" required>
  JSON-RPC method name.
</ParamField>

<ParamField body="params" type="object" default={[{"fromBlock":"0x1","toBlock":"0x2","address":"0x8888f1f195afa192cfee860698584c030f4c9db1","topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",null,["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b","0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc"]]}]} placeholder="[{&#x22;fromBlock&#x22;:&#x22;0x1&#x22;,&#x22;toBlock&#x22;:&#x22;0x2&#x22;,&#x22;address&#x22;:&#x22;0x8888f1f195afa192cfee860698584c030f4c9db1&#x22;,&#x22;topics&#x22;:[&#x22;0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b&#x22;,null,[&#x22;0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b&#x22;,&#x22;0x000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc&#x22;]]}]" required>
  Parameters for eth\_newFilter: \[filterObject]. See below for filterObject properties.

  Positional parameters for <code>eth\_newFilter</code>:

  <ul>
    <li><code>params\[0]</code>: 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>
</ParamField>

### Returns

<ResponseField name="result" type="string">
  Quantity - The filter ID. Example: <code>"0x1"</code>.
</ResponseField>

<RequestExample>
  ```bash Curl theme={null}
  curl --request POST \
    --url https://api.uniblock.dev/uni/v1/json-rpc?chainId=11011 \
    --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"
            ]
          ]
        }
      ]
    }'
  ```
</RequestExample>

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