eth_getFilterLogs

eth_getFilterLogs returns the full set of logs matching a log filter you already created on Arbitrum One, ignoring whatever you have polled before. Arbitrum One (chain ID 42161) is an Optimistic Rollup that pays gas in ETH and settles batches to Ethereum L1; its high event throughput from protocols like GMX and Uniswap makes one-shot snapshots handy. Send the request to https://arbitrum.therpc.io/YOUR_API_KEY with a log filter ID and it returns all logs matching the filter's criteria, regardless of prior poll state.

Use cases

• Load the complete historical log set for a filter when your Arbitrum One indexer starts up, then switch to incremental eth_getFilterChanges polling.
• Replay every event missed during downtime after a service restart by calling eth_getFilterLogs once before resuming the eth_getFilterChanges loop.

Parameters

Response

Example request

1curl https://arbitrum.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 Arbitrum One playground.

Errors & troubleshooting

Common pitfalls

• Unlike eth_getFilterChanges, this returns ALL matching logs every time, not just new ones — on a wide Arbitrum One filter that can be heavy and may trip the 10,000-result cap.
• It accepts only log filters from eth_newFilter; a block-filter or pending-tx-filter ID returns a filter not found error.
• Filters expire after about 5 minutes of inactivity, so call eth_getFilterLogs promptly after creating the filter.

Supported networks

• Mainnet — Chain ID: 42161
• Sepolia — Chain ID: 421614

See also

• eth_newFilter
• eth_getFilterChanges
• eth_uninstallFilter
• eth_getLogs

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