1. Home
  2. Docs
  3. Polygon
  4. Polygon POS Chain Developer APIs
  5. 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?