eth_getFilterLogs

eth_getFilterLogs returns the full set of logs on OP Mainnet that match a log filter you created with eth_newFilter, ignoring how much you have already polled — every matching entry comes back, not just the new ones. OP Mainnet is an OP Stack optimistic rollup (Bedrock) settling to Ethereum L1, with gas paid in ETH and blocks roughly every two seconds, so a filter spanning even a modest time window can cover many blocks. Send the request to https://optimism.therpc.io/YOUR_API_KEY (chain ID 10, 0xa).

Use cases

• On application start, load the complete historical log set for a filter (for example every swap on a Velodrome pool over its fromBlock–toBlock range) before switching to incremental eth_getFilterChanges polling.
• After a service restart on OP Mainnet, replay all missed events by calling eth_getFilterLogs once to catch up, then resume eth_getFilterChanges for new deltas.

Parameters

Response

Example request

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "eth_getFilterLogs",
7    "params": ["0x1"],
8    "id": 1
9  }'

Try it live in the Optimism playground.

Errors & troubleshooting

Common pitfalls

• Unlike eth_getFilterChanges, this returns every matching log, not just new ones — for a wide filter over many OP Mainnet blocks it can be heavy and may hit the result cap.
• It accepts only log filters from eth_newFilter; passing a block-filter or pending-tx-filter ID returns an error.
• Filters expire after about five minutes of inactivity, so call eth_getFilterLogs promptly after creating the filter rather than letting it sit idle.

Supported networks

• Mainnet — Chain ID: 10
• Sepolia — Chain ID: 11155420

See also

• eth_newFilter
• eth_getFilterChanges
• eth_uninstallFilter
• eth_getLogs

1curl https://optimism.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getFilterLogs","params":["0x1"]}'