eth_getLogs

Returns an array of logs matching the given filter criteria.

Returns an array of logs matching the given filter criteria. 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.

Parameters

filterObject · object · required

The log filter object. At least one filter criterion should be provided.

Show Filter object fields

fromBlock · string

Start of the block range. Block number in hexadecimal or a block tag. Defaults to "latest".

toBlock · string

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

address · string | array

A single contract address or array of addresses to filter logs 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 topic hex strings (match any in the array). Position 0 is typically the keccak256 hash of the event signature. Optional.

blockHash · string

A specific block hash to restrict results to that single block only. If provided, fromBlock and toBlock are ignored. Optional.

Returns

result · array

An 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 the event signature hash for named events.

data · string

ABI-encoded non-indexed event parameters.

blockNumber · string

Block number in which this log was emitted.

transactionHash · string

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

transactionIndex · string

Index of the transaction in the block.

blockHash · string

32-byte hash of the block.

logIndex · string

Log’s index position within the block.

removed · boolean

true if the log was removed due to a chain reorganization. false for valid logs.

Flashblocks Behavior

On a Flashblocks-aware endpoint, use "pending" as the block parameter to query preconfirmed state — data available up to 200ms before the next full block is sealed.

Set toBlock to "pending" to include logs from preconfirmed Flashblock transactions. Useful for monitoring contract events with sub-block latency.

cURL (preconfirmed state)

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

Example

Request

{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x12ced00",
      "toBlock": "0x12ced28",
      "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ]
    }
  ],
  "id": 1
}