eth_getLogs
Returns an array of all logs matching the specified filter.
### Supported Block Ranges
Here are the block ranges you're able to submit in a single query, depending on your plan tier:
> ⚠️ Note: All responses will be capped at 150MB.
| Chain | Free | Pay As You Go | Enterprise |
|-------|------|---------------|------------|
| Ethereum, Base, Optimism, Arbitrum, Worldchain, zkSync | 10 | unlimited | unlimited |
| Polygon | 10 | 2000 | unlimited |
| BSC, Unichain | 10 | 10,000 | 10,000 |
| Berachain, Plasma | 10 | 10,000 | 100,000 |
| Monad | 10 | 1000 | 1000 |
| Polygon zkEVM | 10 | 10,000 | 20,000 |
| Sei | 10 | 2000 | 2000 |
| All Other Chains | 10 | 10,000 | 10,000*** |
*** Note: Querying block ranges wider than 10k for these chains is possible but less likely to succeed. Try splitting large queries into smaller parts to boost performance and reduce the likelihood of failure.
Path Parameters
apiKey
Request
This endpoint expects an object.
Filter
The filter options object to specify the criteria for logs retrieval.
Response
An array of log objects matching the filter criteria.
OR
new logs