Logs - Etherscan

Etherscan

Home Twitter Knowledge Base API PRO

Search…

Rinkeby Etherscan

Rinkeby Testnet

🎯

API Endpoints

Visit Rinkeby Etherscan

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 9548877 to 'latest' , where log address = 0x01BE23585060835E02B77ef475b0Cc51aA1e0709 and topic[0] = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
1
https://api-rinkeby.etherscan.io/api
2
   ?module=logs
3
   &action=getLogs
4
   &fromBlock=9548877
5
   &toBlock=latest
6
   &address=0x01BE23585060835E02B77ef475b0Cc51aA1e0709
7
   &topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
8
   &apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser 🔗
​
Get Event Logs from block number 9433622 to block 'latest', where log address = 0x5592ec0cfb4dbc12d3ab100b257153436a1f0fea, topic[0] = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef 'AND' topic[1] = 0x0000000000000000000000008e811410ce01e0244808af95bba906b8ab77a40b
1
https://api-rinkeby.etherscan.io/api
2
   ?module=logs
3
   &action=getLogs
4
   &fromBlock=9433622
5
   &toBlock=latest
6
   &address=0x5592ec0cfb4dbc12d3ab100b257153436a1f0fea
7
   &topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
8
   &topic0_1_opr=and
9
   &topic1=0x0000000000000000000000008e811410ce01e0244808af95bba906b8ab77a40b
10
   &apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser 🔗
​

API Endpoints - Previous

Blocks

Next - API Endpoints

Geth/Parity Proxy

Last modified 2mo ago

Copy link

Contents

Sample Log API Queries