eth_getFilterLogs

eth_getFilterLogs returns the full set of logs that match a log filter you created with eth_newFilter, ignoring how many times you have already polled it — you get the complete match set, not just the delta. This makes it the natural companion to eth_getFilterChanges: use this once for the baseline, then switch to incremental polling. Base is Coinbase's OP Stack rollup that settles to Ethereum L1 and pays gas in ETH, and its high event volume from apps like Aerodrome and Uniswap means a wide filter can return a lot at once. Call it at https://base.therpc.io/YOUR_API_KEY (chain ID 8453, hex 0x2105) with the filter ID.

Use cases

• Load the complete historical match set for a filter when your Base indexer boots, then hand off to eth_getFilterChanges for the live tail.
• Replay everything missed during downtime: after a service restart, call eth_getFilterLogs to recover the full window before resuming incremental polls, so no Base events fall through the gap.

Parameters

Response

Example request

1curl https://base.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 Base playground.

Errors & troubleshooting

Common pitfalls

• Unlike eth_getFilterChanges, this returns every matching log each time, not just new ones — on a broad Base filter that can be heavy and may trip the 10,000-result cap, so scope the filter tightly.
• It accepts log filters from eth_newFilter only; passing a block filter or pending-transaction filter ID returns filter not found.
• The filter expires after about 5 minutes of inactivity, so call eth_getFilterLogs promptly after creating it rather than letting it sit idle.

Supported networks

• Mainnet — Chain ID: 8453
• Sepolia — Chain ID: 84532

See also

• eth_newFilter
• eth_getFilterChanges
• eth_uninstallFilter
• eth_getLogs

1curl https://base.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"]}'