1. Home
  2. Docs
  3. Polygon POS Chain Developer APIs
  4. Logs APIs

Logs APIs

Logs APIs

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)

– 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


Here are some examples of how this filter maybe used:

Get Event Logs from block number 5000000 to 6000000 Block, where log address = 0x0000000000000000000000000000000000001010 and topic[0] = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef

https://api.polygonscan.com/api?module=logs&action=getLogs
&fromBlock=5000000
&toBlock=6000000
&address=0x0000000000000000000000000000000000001010
&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
&apikey=YourApiKeyToken

Get Event Logs from block number 5000000 to block 6000000 , where log address = 0x0000000000000000000000000000000000001010, topic[0] = 0x4dfe1bbbcf077ddc3e01291eea2d5c70c2b422b415d95645b9adcfd678cb1d63 ‘AND’ topic[1] = 0x0000000000000000000000000000000000000000000000000000000000001010

https://api.polygonscan.com/api?module=logs&action=getLogs
&fromBlock=5000000
&toBlock=6000000
&address=0x0000000000000000000000000000000000001010
&topic0=0x4dfe1bbbcf077ddc3e01291eea2d5c70c2b422b415d95645b9adcfd678cb1d63
&topic0_1_opr=and
&topic1=0x0000000000000000000000000000000000000000000000000000000000001010
&apikey=YourApiKeyToken

Originally published @ https://polygonscan.com/apis#logs

Was this article helpful to you? Yes 1 No

How can we help?