# DEX Events

Key tables:

* **V2 Mints, Burns, and Syncs**: Events related to LP token minting, burning, and pool synchronization for V2 protocols.
* **V2 Transfers**: Tracks transfers of LP tokens between addresses on V2 DEX protocols.
* **V3 Events**: Records of liquidity position changes, including minting, burning, and transfers, specific to V3 protocols.
* **V3 Transfers**: Tracks transfers of LP tokens between addresses on V3 DEX protocols. 

{% tabs %}
{% tab title="V2 Mints" %}

| Property                   | Description                                                                                    | Type   |
| -------------------------- | ---------------------------------------------------------------------------------------------- | ------ |
| timestamp                  | The timestamp of the record.                                                                   | number |
| chain\_id                  | The standard id of the chain.                                                                  | number |
| block\_number              | The block number of the mint.                                                                  | number |
| log\_index                 | The event log. For transactions that don't emit event, create arbitrary index starting from 0. | number |
| transaction\_hash          | The hash of the transaction.                                                                   | string |
| transaction\_from\_address | The address that initiates the transaction (ie, the transaction signer).                       | string |
| from\_address              | The from address of the event (ie, the from field in a transfer).                              | string |
| to\_address                | The to address of the event (ie, the to field in a transfer).                                  | string |
| pool\_address              | The contract address of the pool.                                                              | string |
| token0\_address            | The contract address of token0.                                                                | string |
| token0\_amount             | The amount of token0.                                                                          | number |
| token1\_address            | The contract address of token1.                                                                | string |
| token1\_amount             | The amount of token1.                                                                          | number |
| mint\_amount               | The amount of LP token minted by the trader, decimal normalized.                               | number |
| mint\_amount\_usd          | (Optional) The amount of the mint in USD.                                                      | number |
| {% endtab %}               |                                                                                                |        |

{% tab title="V2 Burns" %}

| Property                   | Description                                                                                    | Type    |
| -------------------------- | ---------------------------------------------------------------------------------------------- | ------- |
| timestamp                  | The timestamp of the transaction.                                                              | number  |
| chain\_id                  | The standard id of the chain.                                                                  | number  |
| block\_number              | The block number of the trade.                                                                 | number  |
| log\_index                 | The event log. For transactions that don't emit event, create arbitrary index starting from 0. | number  |
| transaction\_hash          | The hash of the transaction.                                                                   | string  |
| transaction\_from\_address | The address that initiates the transaction (ie, the transaction signer).                       | string  |
| from\_address              | The from address of the event (ie, the from field in a transfer).                              | string  |
| to\_address                | The to address of the event (ie, the to field in a transfer).                                  | string  |
| pool\_address              | The contract address of the pool.                                                              | string  |
| token0\_address            | The contract address of token0.                                                                | string  |
| token0\_amount             | The amount of token0.                                                                          | number  |
| token1\_address            | The contract address of token1.                                                                | string  |
| token1\_amount             | The amount of token1.                                                                          | number  |
| burn\_amount               | The amount of LP tokens burned, decimal normalized.                                            | number  |
| burn\_amount\_usd          | (Optional) The amount of the burn in USD.                                                      | vnumber |
| {% endtab %}               |                                                                                                |         |

{% tab title="V2 Sync" %}

| Property          | Description                                                                                    | Type   |
| ----------------- | ---------------------------------------------------------------------------------------------- | ------ |
| timestamp         | The timestamp of the transaction.                                                              | number |
| chain\_id         | The standard id of the chain.                                                                  | number |
| block\_number     | The block number of the trade.                                                                 | number |
| log\_index        | The event log. For transactions that don't emit event, create arbitrary index starting from 0. | number |
| transaction\_hash | The hash of the transaction.                                                                   | string |
| pool\_address     | The contract address of the pool.                                                              | string |
| token0\_address   | The contract address of token0.                                                                | string |
| token0\_amount    | The amount of token0.                                                                          | number |
| token1\_address   | The contract address of token1.                                                                | string |
| token1\_amount    | The amount of token1.                                                                          | number |
| {% endtab %}      |                                                                                                |        |

{% tab title="V2 Transfers" %}

| Property                   | Description                                                                                    | Type   |
| -------------------------- | ---------------------------------------------------------------------------------------------- | ------ |
| timestamp                  | The timestamp of the transaction.                                                              | number |
| chain\_id                  | The standard id of the chain.                                                                  | number |
| block\_number              | The block number of the trade.                                                                 | number |
| log\_index                 | The event log. For transactions that don't emit event, create arbitrary index starting from 0. | number |
| transaction\_hash          | The hash of the transaction.                                                                   | string |
| transaction\_from\_address | The address that initiates the transaction (ie, the transaction signer).                       | string |
| from\_address              | The address that sends the LP token.                                                           | string |
| to\_address                | The address that receives the LP token.                                                        | string |
| pool\_address              | The contract address of the pool.                                                              | string |
| pool\_token\_balance       | The balance of the pool token, decimal normalized.                                             | number |
| {% endtab %}               |                                                                                                |        |

{% tab title="V3 Events" %}

| Property                   | Description                                                                                    | Type   |
| -------------------------- | ---------------------------------------------------------------------------------------------- | ------ |
| timestamp                  | The timestamp of the transaction.                                                              | number |
| chain\_id                  | The standard id of the chain.                                                                  | number |
| block\_number              | The block number of the trade.                                                                 | number |
| log\_index                 | The event log. For transactions that don't emit event, create arbitrary index starting from 0. | number |
| transaction\_hash          | The hash of the transaction.                                                                   | string |
| transaction\_from\_address | The address that initiates the transaction (ie, the transaction signer).                       | string |
| event\_type                | The action type of the event (ie, mint, burn).                                                 | string |
| pool\_address              | The contract address of the pool.                                                              | string |
| tick\_lower                | The lower tick of the liquidity position.                                                      | number |
| tick\_upper                | The upper tick of the liquidity position.                                                      | number |
| current\_tick              | The current tick of the liquidity pool.                                                        | number |
| tick\_spacing              | The tick spacing of the liquidity pool.                                                        | number |
| nft\_token\_id             | The token ID of the NFT that represents the liquidity position                                 | number |
| token0\_address            | The contract address of token0.                                                                | string |
| token0\_amount             | The amount of token0(raw token amount).                                                        | number |
| token1\_address            | The contract address of token1.                                                                | string |
| token1\_amount             | The amount of token1(raw token amount).                                                        | number |
| token\_fees                | The amount of token fees.                                                                      | number |
| amount\_liquidity          | The amount of liquidity.                                                                       | number |
| {% endtab %}               |                                                                                                |        |

{% tab title="V3 Transfers" %}

| Property                   | Description                                                                                    | Type   |
| -------------------------- | ---------------------------------------------------------------------------------------------- | ------ |
| timestamp                  | The timestamp of the transaction.                                                              | number |
| chain\_id                  | The standard id of the chain.                                                                  | number |
| block\_number              | The block number of the trade.                                                                 | number |
| log\_index                 | The event log. For transactions that don't emit event, create arbitrary index starting from 0. | number |
| transaction\_hash          | The hash of the transaction.                                                                   | string |
| transaction\_from\_address | The address that initiates the transaction (ie, the transaction signer).                       | string |
| from\_address              | The from address of the event (ie, the from field in a transfer).                              | string |
| to\_address                | The to address of the event (ie, the to field in a transfer).                                  | string |
| event\_type                | The action type of the event (ie, transfer).                                                   | string |
| pool\_address              | The contract address of the pool.                                                              | string |
| tick\_lower                | The lower tick.                                                                                | number |
| tick\_upper                | The upper tick.                                                                                | number |
| tick\_spacing              | The tick spacing.                                                                              | number |
| token0\_address            | The contract address of token0.                                                                | string |
| token0\_amount             | The amount of token0.                                                                          | number |
| token1\_address            | The contract address of token1.                                                                | string |
| token1\_amount             | The amount of token1.                                                                          | number |
| token\_fees                | The amount of token fees.                                                                      | number |
| amount\_liquidity          | The amount of liquidity.                                                                       | number |
| {% endtab %}               |                                                                                                |        |
| {% endtabs %}              |                                                                                                |        |