eth_getLogs

Returns logs matching a filter. Use pending on a Flashblocks endpoint to query logs from pre-confirmed transactions.

Returns an array of all logs matching a given filter object. Particularly useful for indexing on-chain events.

Queries spanning large block ranges or high-activity contracts can time out or be rejected. Keep fromBlock-to-toBlock ranges under 2,000 blocks for reliable results. Node providers may enforce their own limits.

Flashblocks: Set "fromBlock": "pending" and "toBlock": "pending" on a https://mainnet-preconf.base.org endpoint to query logs from pre-confirmed transactions, updated every ~200ms. For a real-time stream, consider the pendingLogs WebSocket subscription instead.

Parameters

filter · object · required

The filter options. At least one criterion should be provided.

Show Filter fields

fromBlock · string

Start of the block range. Block number in hex or a block tag. Use "pending" on a Flashblocks endpoint to include pre-confirmed logs. Defaults to "latest".

toBlock · string

End of the block range. Block number in hex or a block tag. Defaults to "latest".

address · string | array

A contract address or array of addresses to filter by. Optional.

topics · array

Array of 32-byte topic filters. Each position can be null (match any), a single topic hex string, or an array of hex strings (match any in the array). Position 0 is typically the keccak256 hash of the event signature. Optional.

blockHash · string

Restricts logs to the block with this hash. If provided, fromBlock and toBlock are ignored. Optional.

Returns

result · array

Array of log objects matching the filter.

Show Log object fields

address · string

20-byte address of the contract that emitted the log.

topics · array

Array of 0–4 indexed 32-byte topics. Topic 0 is typically the event signature hash.

data · string

ABI-encoded non-indexed event parameters.

blockNumber · string

Block number in which this log was emitted (hex).

transactionHash · string

32-byte hash of the transaction that emitted this log.

transactionIndex · string

Index of the transaction in the block (hex).

blockHash · string

32-byte hash of the block.

logIndex · string

Log’s index position within the block (hex).

removed · boolean

true if the log was removed due to a chain reorganization.

Example

Standard (block range)

curl https://mainnet.base.org \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [{
      "fromBlock": "0x12ced00",
      "toBlock": "0x12ced28",
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"]
    }],
    "id": 1
  }'