# Eth\_newFilter

## Create a new log filter

> Sends a JSON-RPC request to create a new filter for tracking log events. \
> Returns a filter ID which can be used to query logs using \`eth\_getFilterChanges\` or \`eth\_getFilterLogs\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"Ethereum JSON-RPC","version":"1.0.0"},"servers":[{"url":"https://zksync.nownodes.io"}],"security":[{"api-keyAuth":[]}],"components":{"securitySchemes":{"api-keyAuth":{"type":"apiKey","in":"header","name":"api-key"}}},"paths":{"/":{"post":{"tags":["eth_newFilter"],"summary":"Create a new log filter","operationId":"ethNewFilter","description":"Sends a JSON-RPC request to create a new filter for tracking log events. \nReturns a filter ID which can be used to query logs using `eth_getFilterChanges` or `eth_getFilterLogs`.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method","params","id"],"properties":{"jsonrpc":{"type":"string"},"method":{"type":"string"},"params":{"type":"array","description":"Array with one object describing the filter options","items":{"type":"object","properties":{"fromBlock":{"type":"string","description":"Starting block number or tag (`\"latest\"`, `\"earliest\"`, `\"pending\"`)"},"toBlock":{"type":"string","description":"Ending block number or tag"},"address":{"oneOf":[{"type":"string","description":"Single address to filter by"},{"type":"array","description":"Multiple addresses to filter by","items":{"type":"string"}}],"nullable":true},"topics":{"type":"array","description":"Array of topic filters. Topics are 32-byte hashes identifying events","items":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"nullable":true}}}},"id":{"type":"integer"}}}}}},"responses":{"200":{"description":"Filter ID created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string"},"id":{"type":"integer"},"result":{"type":"string","description":"Filter identifier as a hex string"}}}}}}}}}}}
```