# 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 %} | | | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.openblocklabs.com/data-offering/dex-events.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.