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 4993830 to 4993832 Block, where log address = 0xe561479bebee0e606c19bb1973fc4761613e3c42 and topic[0] = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef

1
https://api.bscscan.com/api
2
?module=logs
3
&action=getLogs
4
&fromBlock=4993830
5
&toBlock=4993832
6
&address=0xe561479bebee0e606c19bb1973fc4761613e3c42
7
&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
8
&apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser ​
πŸ”—
​

Get Event Logs from block number 4993830 to block 4993832 , where log address = 0xe561479bebee0e606c19bb1973fc4761613e3c42, topic[0] = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef 'AND' topic[1] = 0x000000000000000000000000730e2065b9daee84c3003c05bf6d2b3a08e55667

1
https://api.bscscan.com/api
2
?module=logs
3
&action=getLogs
4
&fromBlock=4993830
5
&toBlock=4993832
6
&address=0xe561479bebee0e606c19bb1973fc4761613e3c42
7
&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
8
&topic0_1_opr=and
9
&topic1=0x000000000000000000000000730e2065b9daee84c3003c05bf6d2b3a08e55667
10
&apikey=YourApiKeyToken
Copied!
Try this endpoint in your browser ​
πŸ”—
​
Copy link