> ## 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.

# Fees

### Table Details

| Property          | Value                           |
| ----------------- | ------------------------------- |
| Table Name        | `optimism.dex.fees`             |
| Table Status      | Production-Ready                |
| Unique Key        | `transaction_hash`, `unique_id` |
| Clustering Key(s) | `block_timestamp::date`         |

### Table Columns

| Column Name                | Data Type         | Description                                                                                                                                                                                             |
| -------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| sector                     | VARCHAR(16777216) | The fee sector this row belongs to (`dex`, `lending`, `chain`, `liquid_staking`, ...). Every sector shares the same three fee layers; only the atomic grain and where fee info comes from change.       |
| chain                      | VARCHAR(16777216) | Slug identifying the blockchain this record belongs to (e.g. `ethereum`, `base`, `avalanche`). In per-chain tables this is always the same value; in cross-chain tables it identifies the source chain. |
| project                    | VARCHAR(16777216) | Business name of the protocol being used (e.g. `uniswap`, `aave`, `lido`, `paraswap`). Consistent across verticals — every table with a `project` column uses this field for the top-level brand.       |
| protocol                   | VARCHAR(16777216) | Specific version or variant of the protocol (e.g. `uniswap_v3`, `aave_v2`, `stargate_v2`). Qualifies the `project` field with version information.                                                      |
| liquidity\_pool\_address   | VARCHAR(42)       | Contract address of the liquidity pool where this trade was executed. Null when the routing path is not emitted by the event (common for aggregator trades).                                            |
| factory\_address           | VARCHAR(42)       | Address of the factory contract that deployed this liquidity pool. Factory contracts create and track pool instances for a given protocol version.                                                      |
| token\_sold\_address       | VARCHAR(42)       | Contract address of the token sold (given) in this swap.                                                                                                                                                |
| token\_sold\_symbol        | VARCHAR(16777216) | Ticker symbol of the token sold in this swap.                                                                                                                                                           |
| token\_bought\_address     | VARCHAR(42)       | Contract address of the token bought (received) in this swap.                                                                                                                                           |
| token\_bought\_symbol      | VARCHAR(16777216) | Ticker symbol of the token bought in this swap.                                                                                                                                                         |
| usd\_amount                | FLOAT             | USD value of the token amount at the time of the event, computed using the hourly USD exchange rate.                                                                                                    |
| pool\_fee                  | NUMBER(38,0)      | The pool's fee parameter in raw pool-creation-event units. Divide by the registry's per-factory `fee_scale` for the fraction — units vary by fork (1e6 vs 1e4), so the raw value needs its factory.     |
| fee\_rate                  | FLOAT             | The pool's fee tier as a fraction (raw pool fee / registry `fee_scale`), e.g. 0.003 for a 0.3% pool.                                                                                                    |
| fee\_usd                   | FLOAT             | Fee paid on this swap in USD: `usd_amount` x `fee_rate`. What users pay, not what the protocol keeps. NULL when the pool is missing from the registry-pinned factories or the swap has no USD value.    |
| take\_rate                 | FLOAT             | Fraction of the fee accruing to the protocol, from the revenue registry. 0 is a confirmed zero protocol share (fee switch verified off), distinct from NULL, which means unconfirmed.                   |
| revenue\_usd               | FLOAT             | Protocol revenue accrued on this row in USD: `fee_usd` x `take_rate`. NULL when the take rate is unconfirmed, never silently 0.                                                                         |
| supply\_side\_usd          | FLOAT             | The supply side's share of the fee in USD (liquidity providers for DEX): `fee_usd` minus `revenue_usd`. Most of the gap between fees and revenue lands here.                                            |
| methodology                | VARCHAR(16777216) | Slug of the fee derivation methodology, resolvable in `crosschain.metrics.fees_coverage_and_methodology` where the derivation and its citation are published.                                           |
| sender\_address            | VARCHAR(42)       | Address that initiated the swap.                                                                                                                                                                        |
| to\_address                | VARCHAR(42)       | Address that received in this event. For token transfers, the account whose balance increased. For transactions, the destination address (may be a smart contract).                                     |
| transaction\_from\_address | VARCHAR(42)       | Address of the externally-owned account (EOA) that signed and submitted the transaction. This is the wallet that paid gas, which may differ from the individual transfer's `from_address`.              |
| transaction\_hash          | VARCHAR(66)       | Hash of the transaction that produced this record. Uniquely identifies a transaction within the blockchain.                                                                                             |
| log\_index                 | NUMBER(38,0)      | Zero-based position of this event log within its transaction. The first log emitted by a transaction has index 0.                                                                                       |
| transaction\_index         | NUMBER(38,0)      | Zero-based position of the transaction within its block. The first transaction in a block has index 0.                                                                                                  |
| block\_timestamp           | TIMESTAMP\_NTZ(9) | Timestamp (UTC) of the block that contains this record.                                                                                                                                                 |
| block\_number              | NUMBER(38,0)      | Sequential number of the block that contains this record. Starts at 0 (genesis block) and increments by 1 for each new block.                                                                           |
| unique\_id                 | VARCHAR(16777216) | Allium's deterministic unique identifier for this row. Passes through 1:1 from `dex.trades`, so rows join back to the trade that produced them.                                                         |
| \_created\_at              | TIMESTAMP\_NTZ(9) | Timestamp of when the entry was created in the database.                                                                                                                                                |
| \_updated\_at              | TIMESTAMP\_NTZ(9) | Timestamp of when the entry was last updated in the database.                                                                                                                                           |

### Related Docs

* [EVM DEX Fees](/historical-data/supported-blockchains/evm/core-schemas/dex/fees)
