eth_getLogs

eth_getLogs returns all event logs emitted on-chain that match a single filter object. It is the workhorse for indexing contract activity: ERC-20 Transfers, swaps, mints, governance events — anything emitted with LOG0–LOG4.

You select logs in one of two mutually exclusive ways:

• By block range — set fromBlock and toBlock (tags or hex block numbers). The range is inclusive on both ends.
• By a single block — set blockHash to pin the query to exactly one block. blockHash cannot be combined with fromBlock/toBlock.

Within that window you narrow further by address (one or many contracts) and by topics (the indexed event signature and arguments). The result is a flat, chronologically ordered array of log objects; an empty array means nothing matched (this is not an error).

This is a read method available from the free tier. For very large historic sweeps, page through the chain in bounded block windows rather than requesting the full history in one call (see Notes).

JSON-RPC params is a positional array with a single element: [filter].

Response fields

result is an array of log objects. Each object has:

Errors are returned in the standard JSON-RPC error envelope. See the shared errors reference for the full envelope shape and shared codes.

JavaScript (fetch)

const res = await fetch("https://api.triport.io/v1/eth", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.TRIPORT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "eth_getLogs",
    params: [{
      fromBlock: "0x10d4f00",
      toBlock: "0x10d4f10",
      address: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      topics: [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
      ],
    }],
  }),
});


const { result } = await res.json();
console.log(`Matched ${result.length} logs`);
for (const log of result) {
  console.log(`${log.blockNumber} ${log.transactionHash} logIndex=${log.logIndex}`);
}

TypeScript SDK (@triport/sdk)

import { Triport } from "@triport/sdk";


const client = new Triport({ apiKey: process.env.TRIPORT_API_KEY });


const TRANSFER =
  "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef";


const logs = await client.eth.request("eth_getLogs", [{
  fromBlock: "0x10d4f00",
  toBlock: "0x10d4f10",
  address: "0xdAC17F958D2ee523a2206206994597C13D831ec7",
  topics: [TRANSFER],
}]);


console.log(`Matched ${logs.length} logs`);

Python (triport-sdk)

import os
from triport import Triport


client = Triport(api_key=os.environ["TRIPORT_API_KEY"])


TRANSFER = "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"


logs = client.eth.request("eth_getLogs", [{
    "fromBlock": "0x10d4f00",
    "toBlock": "0x10d4f10",
    "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "topics": [TRANSFER],
}])


print(f"Matched {len(logs)} logs")

• Block range vs. block hash: supply either fromBlock/toBlock or blockHash, never both. blockHash is the precise way to read all logs from one specific block regardless of reorgs.
• Bound your ranges: very wide block windows (or unfiltered address + topics) can return large result sets and are slow. For historic indexing, walk the chain in fixed-size windows (e.g. a few thousand blocks per call) and accumulate results. There is no daily quota — pacing is RPS-per-tier with burst.
• Reorgs: logs from recent, non-finalized blocks may later be reorged out; such logs reappear in a subsequent query with removed: true. Query against the finalized tag when you need stability.
• Empty result: a filter that matches nothing returns "result": [], which is a success, not an error.
• Related methods: use eth_getBlockReceipts to pull every receipt (and its logs) for a block, eth_getTransactionReceipt for the logs of a single transaction, and eth_blockNumber to discover the current head before paging.