Skip to main content

​
https://instance_base_url/api?module=logs

​
Get Event Logs by Address and/or Topic(s)

getLogs Event logs for an address and topic. Use and/or with the topic operator to specify topic retrieval options when adding multiple topics. Up to a maximum of 1,000 event logs. Example: 
https://instance_base_url/api
   ?module=logs
   &action=getLogs
   &fromBlock=1379224
   &toBlock=13792288
   &address=0x33990122638b9132ca29c723bdf037f1a891a70c
   &topic0=0xf63780e752c6a54a94fc52715dbc5518a3b4c3c2833d301a204226548a2a8545
   &topic1=0x72657075746174696f6e00000000000000000000000000000000000000000000
   &topic0_1_opr=or
*=required field
  • Request Params
  • Example Result
ParameterDescription
fromBlock*integer block number to start searching for logs. latest is also supported
toBlock*integer block number to stop searching for logs. latest is also supported. Note can be same as fromBlock if looking at logs for a single block
address*string 160-bit code used for identifying contracts. An address and/or topic is required.
topic0*string for first required topic.
topic1string for 2nd optional topic.
topic2string for 3rd optional topic.
topic3string for 4th optional topic.
topic0_1_oproperator when topic 0 and 1 are used. Either and or or
topic0_2_oproperator for topic 0 and topic 2. Either and or or
topic0_3_oproperator for topic 0 and topic 3. Either and or or
topic1_2_oproperator for topic 1 and topic 2. Either and or or
topic1_3_oprthe topic operator for topic 1 and topic 3. Either and or or
topic2_3_oprthe topic operator for topic 2 and topic 3. Either and or or