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 0 to 'latest' , where log address = 0xD60CdA2eFdFD1a88EDb81f60D0c07edbFFBbd6a9 and topic[0] = 0 0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925

https://api-sepolia.xaiscan.io/api
   ?module=logs
   &action=getLogs
   &fromBlock=0
   &toBlock=latest
   &address=0xD60CdA2eFdFD1a88EDb81f60D0c07edbFFBbd6a9
   &topic0=0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Get Event Logs from block number 0 to block 'latest', where log address = 0xD60CdA2eFdFD1a88EDb81f60D0c07edbFFBbd6a9, topic[0] = 0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925 'AND' topic[1] = 0x000000000000000000000000a771665196c732fccf3a2ee4d351c05d748322f6

https://api-sepolia.xaiscan.io/api
   ?module=logs
   &action=getLogs
   &fromBlock=0
   &toBlock=latest
   &address=0xD60CdA2eFdFD1a88EDb81f60D0c07edbFFBbd6a9
   &topic0=0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925
   &topic0_1_opr=and
   &topic1=0x000000000000000000000000a771665196c732fccf3a2ee4d351c05d748322f6
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Last updated