Alchemy Logo

eth_getLogs

POST
/{apiKey}

Returns an array of all logs matching the specified filter.

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.

ChainFreePay As You GoEnterprise
Ethereum, Base, Optimism, Arbitrum, Worldchain, zkSync10unlimitedunlimited
Polygon102000unlimited
BSC, Unichain1010,00010,000
Berachain, Plasma1010,000100,000
Monad1010001000
Polygon zkEVM1010,00020,000
Sei1020002000
All Other Chains1010,00010,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

apiKeystringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

Filterobjectrequired

The filter options object to specify the criteria for logs retrieval.

Responses

200

An array of log objects matching the filter criteria.

Was this page helpful?