Get logs matching filter criteria

POST

https://vinu.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an array of logs that match the filter criteria specified in the params. The filter object supports filtering by block range, addresses, and topics.

Block range limits (changed in the 29 August 2026 upgrade).

The node applies two different caps depending on whether the query can use the log index:

unindexed query (neither address nor topics given): max 100 blocks. Unchanged.
indexed query (address and/or topics given): max 100 000 blocks, down from an effectively unlimited 999 999 999 999 999 999 before that upgrade.

Exceeding either cap returns -32000 too wide blocks range, the limit is <N>. Range is inclusive: toBlock - fromBlock must not exceed the cap. blockHash may be used instead of fromBlock/toBlock to query a single block.

Page in windows of 100 000 blocks or fewer.

Body

application/json

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<object>required

Parameters array with one element: the filter object.

Show child attributes

fromBlockstring

Starting block number (hex string) or "earliest", "latest", "pending".

toBlockstring

Ending block number (hex string) or "earliest", "latest", "pending".

addressstring | Array<string>

Contract address or list of addresses from which logs should originate.

topicsarray

Array of topic filters. Each topic can be a string, null, or an array of strings for OR filtering.

idintegerrequired

Request identifier.

Response

200OK

Array of log objects matching the filter

405Method Not Allowed

Method not served by this endpoint. The body is the plain-text string Method Not Allowed, not JSON.

422Unprocessable Entity

Missing API key - the api-key header was absent. The body is the plain-text string Missing API_key, not JSON.

Get logs matching filter criteria

curl -X POST 'https://vinu.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -H 'api-key: YOUR_API_KEY' \
  -d '{"jsonrpc": "2.0", "method": "eth_getLogs", "params": [{"fromBlock": "0xdf7350", "toBlock": "0xdf73b1", "address": "0xfc00face00000000000000000000000000000000"}], "id": 1}'

import { FetchRequest, JsonRpcProvider } from "ethers";

const request = new FetchRequest("https://vinu.nownodes.io/");
request.setHeader("api-key", "YOUR_API_KEY");

const provider = new JsonRpcProvider(request);
const result = await provider.send("eth_getLogs", [{"fromBlock": "0xdf7350", "toBlock": "0xdf73b1", "address": "0xfc00face00000000000000000000000000000000"}]);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://vinu.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['api-key'] = 'YOUR_API_KEY'
request.body = '{"jsonrpc": "2.0", "method": "eth_getLogs", "params": [{"fromBlock": "0xdf7350", "toBlock": "0xdf73b1", "address": "0xfc00face00000000000000000000000000000000"}], "id": 1}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider(
    "https://vinu.nownodes.io/",
    request_kwargs={"headers": {"api-key": "YOUR_API_KEY"}},
))

response = w3.provider.make_request("eth_getLogs", [
    {
        "fromBlock": "0xdf7350",
        "toBlock": "0xdf73b1",
        "address": "0xfc00face00000000000000000000000000000000",
    },
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://vinu.nownodes.io/", {
    fetchOptions: { headers: { "api-key": "YOUR_API_KEY" } },
  }),
});

const result = await client.request({
  method: "eth_getLogs",
  params: [{"fromBlock": "0xdf7350", "toBlock": "0xdf73b1", "address": "0xfc00face00000000000000000000000000000000"}],
});

console.log(result);

const endpoint = "https://vinu.nownodes.io/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "eth_getLogs", params: [
  {
    "fromBlock": "0xdf7350",
    "toBlock": "0xdf73b1",
    "address": "0xfc00face00000000000000000000000000000000"
  }
], id: 1 });
console.log(result);

const response = await fetch('https://vinu.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "fromBlock": "0xdf7350",
        "toBlock": "0xdf73b1",
        "address": "0xfc00face00000000000000000000000000000000"
      }
    ],
    "id": 1
  }),
});

const data = await response.json();

import requests

payload = {
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
        {
            "fromBlock": "0xdf7350",
            "toBlock": "0xdf73b1",
            "address": "0xfc00face00000000000000000000000000000000",
        },
    ],
    "id": 1,
}

response = requests.post(
    "https://vinu.nownodes.io/",
    json=payload,
    headers={"api-key": "YOUR_API_KEY"},
)

print(response.json())

require 'net/http'
require 'json'

uri = URI('https://vinu.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['api-key'] = 'YOUR_API_KEY'
request.body = '{"jsonrpc": "2.0", "method": "eth_getLogs", "params": [{"fromBlock": "0xdf7350", "toBlock": "0xdf73b1", "address": "0xfc00face00000000000000000000000000000000"}], "id": 1}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0xdf7350",
      "toBlock": "0xdf73b1",
      "address": "0xfc00face00000000000000000000000000000000"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ],
      "data": "0x000000000000000000000000000000000000000000000000000000000000003e8",
      "blockNumber": "0x1b4",
      "transactionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "transactionIndex": "0x0",
      "blockHash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Method Not Allowed

Missing API_key