Logs
Get Event Logs by Address
Returns the event logs from an address, with optional filtering by block range.
https://api.etherscan.io/v2/api
?chainid=1
&module=logs
&action=getLogs
&address=0xbd3531da5cf5857e7cfaa92426877b022e612cf8
&fromBlock=12878196
&toBlock=12878196
&page=1
&offset=1000
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"address":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
"topics":[
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000000000000000000000000000000000000000000000",
"0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",
"0x00000000000000000000000000000000000000000000000000000000000000b5"
],
"data":"0x",
"blockNumber":"0xc48174",
"timeStamp":"0x60f9ce56",
"gasPrice":"0x2e90edd000",
"gasUsed":"0x247205",
"logIndex":"0x",
"transactionHash":"0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
"transactionIndex":"0x"
},
{
"address":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
"topics":[
"0x645f26e653c951cec836533f8fe0616d301c20a17153debc17d7c3dbe4f32b28",
"0x00000000000000000000000000000000000000000000000000000000000000b5"
],
"data":"0x",
"blockNumber":"0xc48174",
"timeStamp":"0x60f9ce56",
"gasPrice":"0x2e90edd000",
"gasUsed":"0x247205",
"logIndex":"0x1",
"transactionHash":"0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
"transactionIndex":"0x"
}
]
}
Get Event Logs by Topics
Returns the events log in a block range, filtered by topics.
https://api.etherscan.io/v2/api
?chainid=1
&module=logs
&action=getLogs
&fromBlock=12878196
&toBlock=12879196
&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
&topic0_1_opr=and
&topic1=0x0000000000000000000000000000000000000000000000000000000000000000
&page=1
&offset=1000
&apikey=YourApiKeyToken
Usage:
For a single topic, specify the topic number such as
topic0
,topic1
,topic2
,topic3
For multiple topics, specify the topic numbers and topic operator either
and
oror
such as below 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)
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"address":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
"topics":[
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000000000000000000000000000000000000000000000",
"0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",
"0x00000000000000000000000000000000000000000000000000000000000000b5"
],
"data":"0x",
"blockNumber":"0xc48174",
"timeStamp":"0x60f9ce56",
"gasPrice":"0x2e90edd000",
"gasUsed":"0x247205",
"logIndex":"0x",
"transactionHash":"0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
"transactionIndex":"0x"
},
{
"address":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8",
"topics":[
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000000000000000000000000000000000000000000000",
"0x000000000000000000000000c45a4b3b698f21f88687548e7f5a80df8b99d93d",
"0x00000000000000000000000000000000000000000000000000000000000000b6"
],
"data":"0x",
"blockNumber":"0xc48174",
"timeStamp":"0x60f9ce56",
"gasPrice":"0x2e90edd000",
"gasUsed":"0x247205",
"logIndex":"0x2",
"transactionHash":"0x4ffd22d986913d33927a392fe4319bcd2b62f3afe1c15a2c59f77fc2cc4c20a9",
"transactionIndex":"0x"
}
]
}
Get Event Logs by Address filtered by Topics
Returns the event logs from an address, filtered by topics and block range.
https://api.etherscan.io/v2/api
?chainid=1
&module=logs
&action=getLogs
&fromBlock=15073139
&toBlock=15074139
&address=0x59728544b08ab483533076417fbbb2fd0b17ce3a
&topic0=0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d
&topic0_1_opr=and
&topic1=0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b
&page=1
&offset=1000
&apikey=YourApiKeyToken
Query Parameters
Sample Response
{
"status":"1",
"message":"OK",
"result":[
{
"address":"0x59728544b08ab483533076417fbbb2fd0b17ce3a",
"topics":[
"0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d",
"0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b",
"0x000000000000000000000000000000000000000000000000000000000000236d",
"0x000000000000000000000000c8a5592031f93debea5d9e67a396944ee01bb2ca"
],
"data":"0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000f207539952d0000",
"blockNumber":"0xe60262",
"timeStamp":"0x62c26caf",
"gasPrice":"0x5e2d742c9",
"gasUsed":"0xfb7f8",
"logIndex":"0x4b",
"transactionHash":"0x26fe1a0a403fd44ef11ee72f3b4ceff590b6ea533684cb279cb4242be463304c",
"transactionIndex":"0x39"
},
{
"address":"0x59728544b08ab483533076417fbbb2fd0b17ce3a",
"topics":[
"0x27c4f0403323142b599832f26acd21c74a9e5b809f2215726e244a4ac588cd7d",
"0x00000000000000000000000023581767a106ae21c074b2276d25e5c3e136a68b",
"0x0000000000000000000000000000000000000000000000000000000000002261",
"0x000000000000000000000000c8a5592031f93debea5d9e67a396944ee01bb2ca"
],
"data":"0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000de0b6b3a7640000",
"blockNumber":"0xe6035b",
"timeStamp":"0x62c27ab1",
"gasPrice":"0x27e523173",
"gasUsed":"0x3b86e",
"logIndex":"0x1d7",
"transactionHash":"0x3a299413cf2c91e376e542efcf3fc308c562da79af6e992401217cc6208c7f74",
"transactionIndex":"0x92"
}
]
}
Last updated