Fees

DEX sector fees at atomic (swap) grain: one row per dex.trades row for every protocol registered in the revenue registry, carrying the fee paid on that swap and its protocol-revenue vs supply-side split. fee_usd is the swap’s usd_amount multiplied by the pool fee tier, where the tier comes from the pool creation event and the fee scale comes from the registry-pinned factory. revenue_usd is fee_usd multiplied by the take rate from the revenue registry. unique_id passes through 1:1 from dex.trades, so rows join back to the trade that produced them.

A take_rate of 0 is a confirmed zero protocol share, distinct from NULL, which means unconfirmed. Revenue null-propagates rather than defaulting to 0, and swaps whose pool is missing from the registry-pinned factories carry NULL fee_usd rather than a fabricated zero.

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.

Overview

Data Verticals

Solana

Hyperliquid

Lighter

Bitcoin Ecosystem

EVM

Cosmos Ecosystem

Move Ecosystem

Other Ecosystems

Table Columns

​Table Columns

Table Columns