eth_getLogs | Alchemy Docs

1 curl -X POST https://bob-mainnet.g.alchemy.com/v2/{apiKey} \ 2 -H "Content-Type: application/json" \ 3 -d '{ 4 "jsonrpc": "2.0", 5 "method": "eth_getLogs", 6 "params": [ 7 { 8 "fromBlock": "0x137d3c2", 9 "toBlock": "0x137d3c3", 10 "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", 11 "topics": [] 12 } 13 ], 14 "id": 1 15 }'

1 { 2 "jsonrpc": "2.0", 3 "id": "1", 4 "result": [ 5 { 6 "logIndex": "0x0", 7 "removed": false, 8 "blockNumber": "0x233", 9 "blockHash": "0xfc139f5e2edee9e9c888d8df9a2d2226133a9bd87c88ccbd9c930d3d4c9f9ef5", 10 "transactionHash": "0x66e7a140c8fa27fe98fde923defea7562c3ca2d6bb89798aabec65782c08f63d", 11 "transactionIndex": "0x0", 12 "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", 13 "data": "0x0000000000000000000000000000000000000000000000000000000000000004", 14 "topics": [ 15 "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" 16 ] 17 }, 18 { 19 "logIndex": "0x0", 20 "removed": false, 21 "blockNumber": "0x238", 22 "blockHash": "0x98b0ec0f9fea0018a644959accbe69cd046a8582e89402e1ab0ada91cad644ed", 23 "transactionHash": "0xdb17aa1c2ce609132f599155d384c0bc5334c988a6c368056d7e167e23eee058", 24 "transactionIndex": "0x0", 25 "address": "0x42699a7612a82f1d9c36148af9c77354759b210b", 26 "data": "0x0000000000000000000000000000000000000000000000000000000000000007", 27 "topics": [ 28 "0x04474795f5b996ff80cb47c148d4c5ccdbe09ef27551820caa9c2f8ed149cce3" 29 ] 30 } 31 ] 32 }

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 and Layer 2s (Ethereum, Base, Optimism, Arbitrum, Worldchain)	10	unlimited	unlimited
Polygon	10	2000	unlimited
Monad	10	1000	1000
BSC	10	10000	10000
All Other Chains	10	10000	unlimited

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 and Layer 2s (Ethereum, Base, Optimism, Arbitrum, Worldchain) | 10 | unlimited | unlimited | | Polygon | 10 | 2000 | unlimited | | Monad | 10 | 1000 | 1000 | | BSC | 10 | 10000 | 10000 | | All Other Chains | 10 | 10000 | unlimited |

Path parameters

apiKeystringRequiredDefaults to docs-demo

Request

This endpoint expects an object.

FilterobjectRequired

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

Response

An array of log objects matching the filter criteria.

list of strings

new logslist of objects