> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Events

> Get events emitted by Sui DEX protocols.

The `dex.events` table contains pool creation, add/remove liquidity events of liquidity pools.  This table is used to track key events such as liquidity addition and removal events.

Currently, we support 7 DEX protocols on Sui.

* cetus, turbos, momentum, flow\_v2, flow\_v3, bluemove, bluefin

<Info>
  - Columns appended with `_str` are in string format and will retain precision.

  - Note that not all columns are applicable to all events.
</Info>

### Table Columns

Unique Key: `unique_id`

| Column Name                     | Description                                                            |
| ------------------------------- | ---------------------------------------------------------------------- |
| event                           | Type of event (e.g., pool\_created, add\_liquidity, remove\_liquidity) |
| project                         | Name of the project (e.g., cetus, bluemove, bluefin)                   |
| package\_id                     | The package ID that contains the DEX protocol implementation           |
| liquidity\_pool\_address        | The liquidity pool address which emitted the event                     |
| sender                          | Address of the sender of the event                                     |
| coin0\_type                     | Coin0 address                                                          |
| coin0\_name                     | Coin0 name                                                             |
| coin0\_symbol                   | Coin0 symbol                                                           |
| coin0\_decimals                 | Coin0 decimals                                                         |
| coin0\_amount\_raw\_str         | Coin0 amount unnormalized, in string format for precision              |
| coin0\_amount\_raw              | Coin0 amount unnormalized                                              |
| coin0\_amount\_str              | Coin0 amount normalized, in string format for precision                |
| coin0\_amount                   | Coin0 amount normalized                                                |
| coin0\_amount\_usd              | Coin0 USD amount                                                       |
| coin0\_price\_usd               | Coin0 hourly USD price at the time of the event                        |
| coin1\_type                     | Coin1 address                                                          |
| coin1\_name                     | Coin1 name                                                             |
| coin1\_symbol                   | Coin1 symbol                                                           |
| coin1\_decimals                 | Coin1 decimals                                                         |
| coin1\_amount\_raw\_str         | Coin1 amount unnormalized, in string format for precision              |
| coin1\_amount\_raw              | Coin1 amount unnormalized                                              |
| coin1\_amount\_str              | Coin1 amount normalized, in string format for precision                |
| coin1\_amount                   | Coin1 amount normalized                                                |
| coin1\_amount\_usd              | Coin1 USD amount                                                       |
| coin1\_price\_usd               | Coin1 hourly USD price at the time of the event                        |
| usd\_amount                     | USD value of the event                                                 |
| position\_id                    | Unique identifier for the liquidity position                           |
| liquidity                       | Liquidity amount in the position                                       |
| tick\_lower                     | Lower tick boundary for concentrated liquidity                         |
| tick\_upper                     | Upper tick boundary for concentrated liquidity                         |
| tick\_spacing                   | Tick spacing for the pool                                              |
| gas\_fees\_mist                 | Gas fees paid in MIST (Sui's native token)                             |
| gas\_fees\_sui\_amount          | Gas fees in SUI amount                                                 |
| gas\_fees\_amount\_usd          | Gas fees in USD                                                        |
| transaction\_block\_digest      | Transaction block digest                                               |
| event\_seq                      | Event sequence number                                                  |
| checkpoint\_timestamp           | Checkpoint timestamp of this event                                     |
| checkpoint\_sequence            | Checkpoint sequence number                                             |
| checkpoint\_digest              | Checkpoint digest                                                      |
| unique\_id                      | Unique ID of each event                                                |
| \_created\_at                   | Timestamp of the entry creation                                        |
| \_updated\_at                   | Timestamp of the entry update                                          |
| \_changed\_since\_full\_refresh | Boolean indicator on whether this table was full-refreshed             |
