# Event logs APIs

### Get Event Logs by address, block number in range and topic

#### **URI**

<table data-header-hidden><thead><tr><th width="119"></th><th></th></tr></thead><tbody><tr><td><strong>network</strong></td><td><strong>uri</strong></td></tr><tr><td><em>Mainnet</em></td><td>GET https://explorerapi.wemix.com/v1/event-logs</td></tr><tr><td><em>Testnet</em></td><td>GET https://explorerapi.test.wemix.com/v1/event-logs</td></tr></tbody></table>

#### **REQUEST PARAMETER**

* **HEADER**

| **key**   | **value** | **required** |
| --------- | --------- | ------------ |
| *api-key* | api-key   | true         |

* **QUERY STRING**

<table data-header-hidden><thead><tr><th></th><th width="198"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>key</strong></td><td><strong>type</strong></td><td><strong>value</strong></td><td><strong>required</strong></td></tr><tr><td><em>address</em></td><td>String</td><td>Contract address</td><td>true</td></tr><tr><td><em>limit</em></td><td>Number</td><td>Maximum number of record will retrieve                                               Default: 50, Max: 1000</td><td>false</td></tr><tr><td><em>offset</em></td><td>Number</td><td>Start retrieve record                                                Default: 0</td><td>false</td></tr><tr><td><em>start_block</em></td><td>Number</td><td><p>Get event logs from block number</p><p>Default: null</p></td><td>false</td></tr><tr><td><em>end_block</em></td><td>Number</td><td><p>Get event logs to block number</p><p>Default: null</p></td><td>false</td></tr><tr><td><em>type</em></td><td>String</td><td>Type of message call:<br>- single<br>- combine</td><td>false</td></tr><tr><td><em>topic_0</em></td><td>String</td><td>topic 0</td><td>true</td></tr><tr><td><em>topic_1</em></td><td>String</td><td>topic 1</td><td>false</td></tr><tr><td><em>topic_2</em></td><td>String</td><td>topic 2</td><td>false</td></tr><tr><td><em>topic_3</em></td><td>String</td><td>topic 3</td><td>false</td></tr><tr><td><em>operand</em></td><td>String</td><td>Type of query:                      - and                                          - or</td><td>false</td></tr></tbody></table>

#### **REQUEST SAMPLE**

```
GET https://explorerapi.wemix.com/v1/event-logs?address=0xeAD50432B7DCb8402208a65bc58951b8ccEF9F08
api-key: 1ba5e446edf1997f67b51bf9e60b3fbba6fa1bf84301115292805d7e24f43539
```

#### RESPONSE PARAMETER

<table data-header-hidden><thead><tr><th width="238"></th><th></th><th></th></tr></thead><tbody><tr><td><strong>key</strong></td><td><strong>type</strong></td><td><strong>value</strong></td></tr><tr><td><em>status</em></td><td>String</td><td>Status of request</td></tr><tr><td><em>message</em></td><td>String</td><td>Message of request</td></tr><tr><td><em>results</em></td><td>List&#x3C;Object></td><td>Results of request</td></tr><tr><td><em>results.count</em></td><td>String</td><td>Total count of event-log</td></tr><tr><td><em>results.data</em></td><td>List&#x3C;Object></td><td>List of data</td></tr><tr><td><em>results.data.timestamp</em></td><td>String</td><td>UTC time when the transaction occurred</td></tr><tr><td><em>results.data.address</em></td><td>String</td><td>Address that relate to this event log</td></tr><tr><td><em>results.data.data</em></td><td>String</td><td>Data of event log</td></tr><tr><td><em>results.data.method</em></td><td>String</td><td>Method of this event log</td></tr><tr><td><em>results.transaction_hash</em></td><td>String</td><td>Transaction hash</td></tr><tr><td><em>results.log_name</em></td><td>String</td><td>Name of log</td></tr><tr><td><em>results.log_abi</em></td><td>String</td><td>Abi of event_log</td></tr><tr><td><em>results.data.transaction_index</em></td><td>String</td><td>Index of transaction</td></tr><tr><td><em>results.data.log_index</em></td><td>String</td><td>Index of log</td></tr><tr><td><em>results.data.topics_count</em></td><td>String</td><td>Number of topic</td></tr><tr><td><em>results.data.topic_0</em></td><td>String</td><td>Value of topic 0</td></tr><tr><td><em>results.data.topic_1</em></td><td>String</td><td>Value of topic 1</td></tr><tr><td><em>results.data.topic_2</em></td><td>String</td><td>Value of topic 2</td></tr><tr><td><em>results.data.topic_3</em></td><td>String</td><td>Value of topic 3</td></tr></tbody></table>

#### **RESPONSE SAMPLE**

````
```json
{
    "status": "200",
    "message": "success",
    "results": {
        "count": "214201",
        "data": [
            {
                "timestamp": "2023-08-10T10:11:05Z",
                "address": "0xead50432b7dcb8402208a65bc58951b8ccef9f08",
                "data": "0x0000000000000000000000009c2d3bb8565c2fc4335c1068dd0b6ca60fb4ecab",
                "method": "0xcdb6c50f",
                "transaction_hash": "0x2098c1cf552111f2a55ea022d832a9bd7a73c5661e62881334aab6e56353bced",
                "log_name": null,
                "log_abi": null,
                "address_type": null,
                "address_extra": null,
                "transaction_index": "0",
                "log_index": "0",
                "topics_count": "1",
                "topic_0": "0xcdb6c50fc95430ac4511195bb0a3cb943f34705415ec82960792a7545a6850bb",
                "topic_1": null,
                "topic_2": null,
                "topic_3": null
            },
            ...
        ]
    }
}
````