Logs
The Event Log API was designed to provide an alternative to the native eth_getLogs.
Below are the list of supported filter parameters:
    fromBlock, toBlock, address
    topic0, topic1, topic2, topic3 (32 Bytes per topic)
    topic0_1_opr (and|or between topic0 & topic1), topic1_2_opr (and|or between topic1 & topic2), topic2_3_opr (and|or between topic2 & topic3), topic0_2_opr (and|or between topic0 & topic2), topic0_3_opr (and|or between topic0 & topic3), topic1_3_opr (and|or between topic1 & topic3)
Some parameters to take note of
πŸ“
​
    FromBlock & ToBlock accepts the blocknumber (integer, NOT hex) or 'latest' (earliest & pending is NOT supported yet)
    Topic Operator (opr) choices are either 'and' or 'or' and are restricted to the above choices only
    FromBlock & ToBlock parameters are required
    An address and/or topic(X) parameters are required, when multiple topic(X) parameters are used the topicX_X_opr (and|or operator) is also required
For performance & security considerations, only the first 1000 results are return. So please narrow down the filter parameters.

Sample Log API Queries

Get Event Logs from block number 379224 to 'latest' Block, where log address = 0x33990122638b9132ca29c723bdf037f1a891a70c and topic[0] = 0xf63780e752c6a54a94fc52715dbc5518a3b4c3c2833d301a204226548a2a8545

1
https://api.etherscan.io/api
2
?module=logs
3
&action=getLogs
4
&fromBlock=379224
5
&toBlock=latest
6
&address=0x33990122638b9132ca29c723bdf037f1a891a70c
7
&topic0=0xf63780e752c6a54a94fc52715dbc5518a3b4c3c2833d301a204226548a2a8545
8
&apikey=YourApiKeyToken
Copied!

Get Event Logs from block number 379224 to block 400000 , where log address = 0x33990122638b9132ca29c723bdf037f1a891a70c, topic[0] = 0xf63780e752c6a54a94fc52715dbc5518a3b4c3c2833d301a204226548a2a8545 'AND' topic[1] = 0x72657075746174696f6e00000000000000000000000000000000000000000000

1
https://api.etherscan.io/api
2
?module=logs
3
&action=getLogs
4
&fromBlock=379224
5
&toBlock=400000
6
&address=0x33990122638b9132ca29c723bdf037f1a891a70c
7
&topic0=0xf63780e752c6a54a94fc52715dbc5518a3b4c3c2833d301a204226548a2a8545
8
&topic0_1_opr=and
9
&topic1=0x72657075746174696f6e00000000000000000000000000000000000000000000
10
&apikey=YourApiKeyToken
Copied!
Last modified 7d ago
Copy link