<!-- Canonical: https://docs.linea.build/api/reference/eth-getlogs -->

> For the complete Linea documentation index, see [llms.txt](/llms.txt).
> Agents can fetch this page as Markdown at [https://docs.linea.build/api/reference/eth-getlogs.md](https://docs.linea.build/api/reference/eth-getlogs.md).

# eth_getLogs

# `eth_getLogs`

Returns logs matching a given filter object.

## Parameters

-   `filter`: _[required]_ Filter object:
    -   `fromBlock`: _[optional]_ Hexadecimal block number, or `latest`, `earliest`.
    -   `toBlock`: _[optional]_ Hexadecimal block number, or `latest`, `earliest`.
    -   `address`: _[optional]_ 20-byte contract address or array of addresses.
    -   `topics`: _[optional]_ Array of 32-byte topic values. Topics are order-dependent; each position can be a single value, an array of values (OR), or `null` (wildcard).
    -   `blockHash`: _[optional]_ 32-byte block hash. If set, `fromBlock` and `toBlock` are ignored.

## Returns

Array of log objects. Each log includes `address`, `topics`, `data`, `blockNumber`, `transactionHash`, `transactionIndex`, `blockHash`, `logIndex`, and `removed`.

## Example

This example retrieves ERC-20 `Transfer` events from the USDC contract across a range of blocks.

### Request

```bash
curl https://rpc.linea.build \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "fromBlock": "0x1ce3100",
        "toBlock": "0x1ce3110",
        "address": "0x176211869ca2b568f2a7d4ee941e073a821ee1ff",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
        ]
      }
    ],
    "id": 1
  }'
```

### Response (abbreviated)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x176211869ca2b568f2a7d4ee941e073a821ee1ff",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000...",
        "0x000000000000000000000000..."
      ],
      "data": "0x...",
      "blockNumber": "0x1ce3105",
      "transactionHash": "0x...",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}
```