Logs

Get Event Logs by Address

Returns the event logs from an address, with optional filtering by block range.

https://gatescan.org/api
   ?module=logs
   &action=getLogs
   &address=0x94a8b59163e204102569880bf6d40dd591051938
   &fromBlock=871852
   &toBlock=871855
   &page=1
   &offset=1000
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	the string representing the address to check for logs
fromBlock	the integer block number to start searching for logs eg. 12878196
toBlock	the integer block number to stop searching for logs eg. 12879196
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page limited to 1000 records per query, use the page parameter for subsequent records

Response

{
   "status":"1",
   "message":"success",
   "data":[
        {
            block: 871854,
            address: '0x94a8b59163e204102569880bf6d40dd591051938',
            topics: [
            '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
            '0x000000000000000000000000c6ef7050fbe638ffd992343c4c8271b9af605d6c',
            '0x00000000000000000000000089d556364a4a86bf0ed1a15bfa12f6e225d3d5e9'
            ],
            data: '0x000000000000000000000000000000000000000000000000000000003b9aca00',
            block_number: '0xd4dae',
            transaction_hash: '0x60ba5eadb0280e37a0f82539407a091260a80da56007a2f2c07e6d67de8dad3c',
            transaction_index: '0x0',
            block_hash: '0x3cc03d8b848f54be795fe4e23926f64e3b6023110aaf5911dd25be31c8073da0',
            log_index: '0x0',
            removed: false
        }
    ]
}

Get Event Logs by Topics

Returns the events log in a block range, filtered by topics.

https://gatescan.org/api
   ?module=logs
   &action=getLogs
   &topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
   &topic1=0x000000000000000000000000c6ef7050fbe638ffd992343c4c8271b9af605d6c
   &topicOperator=and
   &fromBlock=1403521
   &toBlock=1403525
   &page=1
   &offset=1000
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
topic	the topic numbers to search for limited totopic0, topic1, topic2, topic3
topicOperator	the topic operator when multiple topic combinations are used limited to and or or
fromBlock	the integer block number to stop searching for logs eg. 12879196
toBlock	the integer block number to stop searching for logs eg. 12879196
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page limited to 1000 records per query, use the page parameter for subsequent records

Response

{
   "status":"1",
   "message":"success",
    "data":[
        {
            block: 871854,
            address: '0x94a8b59163e204102569880bf6d40dd591051938',
            topics: [
            '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
            '0x000000000000000000000000c6ef7050fbe638ffd992343c4c8271b9af605d6c',
            '0x00000000000000000000000089d556364a4a86bf0ed1a15bfa12f6e225d3d5e9'
            ],
            data: '0x000000000000000000000000000000000000000000000000000000003b9aca00',
            block_number: '0xd4dae',
            transaction_hash: '0x60ba5eadb0280e37a0f82539407a091260a80da56007a2f2c07e6d67de8dad3c',
            transaction_index: '0x0',
            block_hash: '0x3cc03d8b848f54be795fe4e23926f64e3b6023110aaf5911dd25be31c8073da0',
            log_index: '0x0',
            removed: false
        }
    ]
}

Get Event Logs by Address filtered by Topics

Returns the event logs from an address, filtered by topics and block range.

https://gatescan.org/api
   ?module=logs
   &action=getLogs
   &address=0x94a8b59163e204102569880bf6d40dd591051938
   &topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
   &topic1=0x000000000000000000000000c6ef7050fbe638ffd992343c4c8271b9af605d6c
   &topicOperator=and,
   &fromBlock=1403521
   &toBlock=1403525
   &page=1
   &offset=1000
   &apikey=YourApiKeyToken

Try this endpoint in your broswer

Request

Parameter	Description
address	the string representing the address to check for logs
topic	the topic numbers to search for limited totopic0, topic1, topic2, topic3
topicOperator	the topic operator when multiple topic combinations are used limited to and or or
fromBlock	the integer block number to stop searching for logs eg. 12879196
toBlock	the integer block number to stop searching for logs eg. 12879196
page	the integer page number, if pagination is enabled
offset	the number of transactions displayed per page limited to 1000 records per query, use the page parameter for subsequent records

Response

{
   "status":"1",
   "message":"success",
   "data":[
        {
            block: 871854,
            address: '0x94a8b59163e204102569880bf6d40dd591051938',
            topics: [
            '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef',
            '0x000000000000000000000000c6ef7050fbe638ffd992343c4c8271b9af605d6c',
            '0x00000000000000000000000089d556364a4a86bf0ed1a15bfa12f6e225d3d5e9'
            ],
            data: '0x000000000000000000000000000000000000000000000000000000003b9aca00',
            block_number: '0xd4dae',
            transaction_hash: '0x60ba5eadb0280e37a0f82539407a091260a80da56007a2f2c07e6d67de8dad3c',
            transaction_index: '0x0',
            block_hash: '0x3cc03d8b848f54be795fe4e23926f64e3b6023110aaf5911dd25be31c8073da0',
            log_index: '0x0',
            removed: false
        }
    ]
}

Last updated on 2025/06/05