eth_getLogs

eth_getLogs returns every event log on OP Mainnet that matches a filter object — by block range (fromBlock/toBlock), contract address, indexed topics, or a single blockHash. It is the primary method for one-shot log queries and backfill indexing, the workhorse behind subgraphs and analytics pipelines tracking Superchain protocols like Velodrome and Synthetix. OP Mainnet is an OP Stack optimistic rollup (Bedrock) that settles to Ethereum L1 and charges gas in ETH; its ~2s blocks mean a given calendar window holds many blocks of logs. Send queries to https://optimism.therpc.io/YOUR_API_KEY (chain ID 10, 0xa).

Use cases

• Backfill ERC-20 Transfer events for a token over a historical OP Mainnet block range to seed a balances index.
• Index DeFi protocol events — Velodrome swaps, Synthetix issuance — for an analytics dashboard.
• Reconstruct contract state from past events when no convenient getter exists on-chain.
• Confirm a specific event was emitted in a given transaction by filtering on its blockHash and topics.

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

Try it live in the Optimism playground.

Errors & troubleshooting

Common pitfalls

• Logs from unsafe (pre-finalized) OP Mainnet blocks can vanish on a reorg — watch the removed field and re-query once the block has finalized on L1 before trusting the data.
• Wide block ranges or filters with no address/topics can trip provider timeouts or block-range caps; paginate in chunks of roughly 1,000–5,000 blocks, which on ~2s blocks still covers a useful span per call.
• Polling eth_getLogs with fromBlock: "latest" in a tight loop wastes CUs — use eth_newFilter plus eth_getFilterChanges, or an eth_subscribe log subscription, for live tailing.

Supported networks

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

See also

• eth_newFilter
• eth_getFilterLogs
• eth_subscribe

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