eth_getLogs

eth_getLogs returns every event log matching a filter object — an address, a set of topics, and a block range — across Arbitrum One. On this Optimistic Rollup (chain ID 42161, gas paid in ETH, batches settled to Ethereum L1), it is the primary method for one-shot log queries and backfill indexing of busy contracts like GMX, Aave, and Camelot. Send the filter to https://arbitrum.therpc.io/YOUR_API_KEY and you get back all event logs matching the filter object in a single response.

Use cases

• Backfill ERC-20 Transfer events for a token contract over a historical Arbitrum One block range.
• Index DeFi protocol events — swaps on Uniswap or Camelot, borrows on Aave — to feed an analytics dashboard.
• Reconstruct a contract's current state by replaying its past events when no direct getter exists.
• Verify that a specific event was emitted inside a given transaction by filtering on its block and topics.

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_getLogs",
7    "params": [{}],
8    "id": 1
9  }'

Try it live in the Arbitrum One playground.

Errors & troubleshooting

Common pitfalls

• Logs from blocks that are only soft-confirmed by the Arbitrum sequencer can disappear in a reorg before they settle to L1 — check the removed field and re-query once the block reaches the finalized tag.
• Wide block ranges or a filter with no address/topics can hit provider timeouts or the block-range and 10,000-result caps; paginate in chunks of roughly 1,000–5,000 blocks. Arbitrum's high block rate means a calendar window covers many blocks, so keep windows small.
• Looping eth_getLogs with fromBlock: "latest" is wasteful — use eth_newFilter + eth_getFilterChanges or eth_subscribe for live tailing instead.

Supported networks

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

See also

• eth_newFilter
• eth_getFilterLogs
• eth_subscribe

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_getLogs","params":[{}]}'