Home

Create a new log filter

POST
https://mantle.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Creates a server-side event log filter and returns a filter ID; poll with eth_getFilterChanges / eth_getFilterLogs.

This is a stateful filter API; availability, filter lifetime, and cross-request routing depend on the specific NOWNodes backend. It has not been tested with an authenticated NOWNodes API key. For portable historical lookups, use eth_getLogs.

Example response values are illustrative unless explicitly described as protocol constants; they are not authenticated live NOWNodes responses.

Body

application/json

JSON-RPC 2.0 request body. Send as HTTP POST to the endpoint root (/).

jsonrpcstring2.0required
methodstringeth_newFilterrequired
paramsArray<object>required

JSON-RPC positional parameters; see example and method description.

Show child attributes
fromBlockstring

Block quantity or tag: earliest, latest, pending; safe/finalized depend on node/fork.

toBlockstring

Block quantity or tag: earliest, latest, pending; safe/finalized depend on node/fork.

blockHashstring

Single block hash; do not combine with fromBlock/toBlock.

addressstring | Array<string>

Emitter address or list of addresses.

topicsArray<string | Array<string> | string>

Up to four position-based topic filters; nested arrays mean OR, null wildcard.

Show child attributes
Any of

32-byte 0x-prefixed hash.

string
Array<string>

null means wildcard

string | null
idintegerrequired

Client-selected JSON-RPC request identifier.

Response

200OK

HTTP response containing a JSON-RPC result or a JSON-RPC error object.

default

JSON-RPC protocol or execution error; may still be delivered with HTTP 200.