eth_getLogs

Returns logs matching a filter.

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.

Since Denim, Base produces a canonical block every 200ms and Flashblocks are retired. The "pending" tag is still accepted, but it no longer returns Flashblocks preconfirmation state. Query logs from canonical blocks, or stream them with eth_subscribe("logs"). See Migrate From Flashblocks.

​

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. 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).

blockTimestamp · string

Unix timestamp of the block containing this log as a hex string. Base L2 extension to the standard Ethereum log schema.

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
  }'