Tables
| View Name | Database | Source | ORDER BY |
|---|---|---|---|
agent.ethereum_dex_trades | agent | dex_ethereum.trades | block_time, tx_hash, evt_index |
agent.base_dex_trades | agent | dex_base.trades | block_time, tx_hash, evt_index |
agent.arbitrum_dex_trades | agent | dex_arbitrum.trades | block_time, tx_hash, evt_index |
agent.bsc_dex_trades | agent | dex_bnb.trades | block_time, tx_hash, evt_index |
agent.tron_dex_trades | agent | dex_tron.trades | block_time, tx_hash, evt_index |
agent.hyperevm_dex_trades | agent | dex_hyperevm.trades | block_time, tx_hash, evt_index |
Related Tables
agent.arbitrum_prices_dayagent.base_prices_dayagent.ethereum_erc20agent.ethereum_fees_dailyagent.ethereum_prices_dayagent.hyperliquid_market_dataagent.hyperliquid_perp_meta
Sample Queries
1. Top 10 DEX protocols by volume today
2. Uniswap V3 WETH/USDC trades in the last 24 hours
Table Schemas
agent.ethereum_dex_trades
Enriched DEX swap events with token symbols, decimals, USD amounts, and protocol attribution. One row per swap event. Combines decoded events from all supported DEX protocols on this chain.
Engine: MergeTree | Partition: toYYYYMM(block_date) | ORDER BY: block_time, tx_hash, evt_index
| Column | Type | Description |
|---|---|---|
blockchain | String | Blockchain network name |
project | String | Protocol name (lowercase): uniswap, sushiswap, curve, pancakeswap, aerodrome, etc. |
version | String | Protocol version string: ‘1’, ‘2’, ‘3’, ‘v3’, ‘slipstream’, etc. |
block_month | Date | UTC block month (partition key) |
block_date | Date | Partition key. Always filter on this column for performance. |
block_time | DateTime64(3) | UTC block timestamp |
block_number | UInt64 | Block number |
token_bought_symbol | Nullable(String) | Symbol of token received |
token_sold_symbol | Nullable(String) | Symbol of token sent |
token_pair | String | Alphabetically sorted pair string (e.g., ‘ETH-USDC’). Useful for GROUP BY. |
token_bought_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_sold_amount | Nullable(Float64) | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_bought_amount_raw | UInt256 | Raw token received amount (pre-decimal) |
token_sold_amount_raw | Nullable(UInt256) | Raw token sent amount (pre-decimal) |
amount_usd | Nullable(Float64) | One-sided USD value of token_sold. Prices from CoinGecko hourly + DEX VWAP. Null for unpriced tokens. |
token_bought_address | Nullable(String) | Bought token contract address |
token_sold_address | Nullable(String) | Sold token contract address |
taker | String | EOA that initiated the swap transaction, not the router/aggregator contract |
maker | Nullable(String) | Liquidity pool address that provided the other side of the trade |
project_contract_address | String | Pool or router contract address |
tx_hash | String | Transaction hash |
tx_from | String | Transaction sender (EOA) |
tx_to | String | Transaction recipient |
evt_index | UInt32 | Event log index in transaction |
agent.base_dex_trades
Enriched DEX swap events with token symbols, decimals, USD amounts, and protocol attribution. One row per swap event. Combines decoded events from all supported DEX protocols on this chain.
Engine: MergeTree | Partition: toYYYYMM(block_date) | ORDER BY: block_time, tx_hash, evt_index
| Column | Type | Description |
|---|---|---|
blockchain | String | Blockchain network name |
project | String | Protocol name (lowercase): uniswap, sushiswap, curve, pancakeswap, aerodrome, etc. |
version | String | Protocol version string: ‘1’, ‘2’, ‘3’, ‘v3’, ‘slipstream’, etc. |
block_month | Date | UTC block month (partition key) |
block_date | Date | Partition key. Always filter on this column for performance. |
block_time | DateTime64(3) | UTC block timestamp |
block_number | UInt64 | Block number |
token_bought_symbol | Nullable(String) | Symbol of token received |
token_sold_symbol | Nullable(String) | Symbol of token sent |
token_pair | String | Alphabetically sorted pair string (e.g., ‘ETH-USDC’). Useful for GROUP BY. |
token_bought_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_sold_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_bought_amount_raw | UInt256 | Raw token received amount (pre-decimal) |
token_sold_amount_raw | UInt256 | Raw token sent amount (pre-decimal) |
amount_usd | Nullable(Float64) | One-sided USD value of token_sold. Prices from CoinGecko hourly + DEX VWAP. Null for unpriced tokens. |
token_bought_address | String | Bought token contract address |
token_sold_address | String | Sold token contract address |
taker | String | EOA that initiated the swap transaction, not the router/aggregator contract |
maker | Nullable(String) | Liquidity pool address that provided the other side of the trade |
project_contract_address | String | Pool or router contract address |
tx_hash | String | Transaction hash |
tx_from | String | Transaction sender (EOA) |
tx_to | String | Transaction recipient |
evt_index | UInt32 | Event log index in transaction |
agent.arbitrum_dex_trades
Enriched DEX swap events with token symbols, decimals, USD amounts, and protocol attribution. One row per swap event. Combines decoded events from all supported DEX protocols on this chain.
Engine: MergeTree | Partition: toYYYYMM(block_date) | ORDER BY: block_time, tx_hash, evt_index
| Column | Type | Description |
|---|---|---|
blockchain | String | Blockchain network name |
project | String | Protocol name (lowercase): uniswap, sushiswap, curve, pancakeswap, aerodrome, etc. |
version | String | Protocol version string: ‘1’, ‘2’, ‘3’, ‘v3’, ‘slipstream’, etc. |
block_month | Date | UTC block month (partition key) |
block_date | Date | Partition key. Always filter on this column for performance. |
block_time | DateTime64(3) | UTC block timestamp |
block_number | UInt64 | Block number |
token_bought_symbol | Nullable(String) | Symbol of token received |
token_sold_symbol | Nullable(String) | Symbol of token sent |
token_pair | String | Alphabetically sorted pair string (e.g., ‘ETH-USDC’). Useful for GROUP BY. |
token_bought_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_sold_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_bought_amount_raw | UInt256 | Raw token received amount (pre-decimal) |
token_sold_amount_raw | UInt256 | Raw token sent amount (pre-decimal) |
amount_usd | Nullable(Float64) | One-sided USD value of token_sold. Prices from CoinGecko hourly + DEX VWAP. Null for unpriced tokens. |
token_bought_address | String | Bought token contract address |
token_sold_address | String | Sold token contract address |
taker | String | EOA that initiated the swap transaction, not the router/aggregator contract |
maker | Nullable(String) | Liquidity pool address that provided the other side of the trade |
project_contract_address | String | Pool or router contract address |
tx_hash | String | Transaction hash |
tx_from | String | Transaction sender (EOA) |
tx_to | String | Transaction recipient |
evt_index | UInt64 | Event log index in transaction |
agent.bsc_dex_trades
Enriched DEX swap events with token symbols, decimals, USD amounts, and protocol attribution. One row per swap event. Combines decoded events from all supported DEX protocols on this chain.
Engine: MergeTree | Partition: toYYYYMM(block_date) | ORDER BY: block_time, tx_hash, evt_index
| Column | Type | Description |
|---|---|---|
blockchain | String | Blockchain network name |
project | String | Protocol name (lowercase): uniswap, sushiswap, curve, pancakeswap, aerodrome, etc. |
version | String | Protocol version string: ‘1’, ‘2’, ‘3’, ‘v3’, ‘slipstream’, etc. |
block_month | Date | UTC block month (partition key) |
block_date | Date | Partition key. Always filter on this column for performance. |
block_time | DateTime | UTC block timestamp |
block_number | UInt64 | Block number |
token_bought_symbol | Nullable(String) | Symbol of token received |
token_sold_symbol | Nullable(String) | Symbol of token sent |
token_pair | String | Alphabetically sorted pair string (e.g., ‘ETH-USDC’). Useful for GROUP BY. |
token_bought_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_sold_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_bought_amount_raw | UInt256 | Raw token received amount (pre-decimal) |
token_sold_amount_raw | UInt256 | Raw token sent amount (pre-decimal) |
amount_usd | Nullable(Float64) | One-sided USD value of token_sold. Prices from CoinGecko hourly + DEX VWAP. Null for unpriced tokens. |
token_bought_address | String | Bought token contract address |
token_sold_address | String | Sold token contract address |
taker | String | EOA that initiated the swap transaction, not the router/aggregator contract |
maker | String | Liquidity pool address that provided the other side of the trade |
project_contract_address | String | Pool or router contract address |
tx_hash | String | Transaction hash |
tx_from | String | Transaction sender (EOA) |
tx_to | String | Transaction recipient |
evt_index | UInt64 | Event log index in transaction |
agent.tron_dex_trades
Enriched DEX swap events with token symbols, decimals, USD amounts, and protocol attribution. One row per swap event. Combines decoded events from all supported DEX protocols on this chain.
Engine: MergeTree | Partition: toYYYYMM(block_date) | ORDER BY: block_time, tx_hash, evt_index
| Column | Type | Description |
|---|---|---|
blockchain | String | Blockchain network name |
project | String | Protocol name (lowercase): uniswap, sushiswap, curve, pancakeswap, aerodrome, etc. |
version | String | Protocol version string: ‘1’, ‘2’, ‘3’, ‘v3’, ‘slipstream’, etc. |
block_month | Date | UTC block month (partition key) |
block_date | Date | Partition key. Always filter on this column for performance. |
block_time | DateTime64(3) | UTC block timestamp |
block_number | UInt64 | Block number |
token_bought_symbol | Nullable(String) | Symbol of token received |
token_sold_symbol | Nullable(String) | Symbol of token sent |
token_pair | String | Alphabetically sorted pair string (e.g., ‘ETH-USDC’). Useful for GROUP BY. |
token_bought_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_sold_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_bought_amount_raw | UInt256 | Raw token received amount (pre-decimal) |
token_sold_amount_raw | UInt256 | Raw token sent amount (pre-decimal) |
amount_usd | Nullable(Float64) | One-sided USD value of token_sold. Prices from CoinGecko hourly + DEX VWAP. Null for unpriced tokens. |
token_bought_address | String | Bought token contract address |
token_sold_address | String | Sold token contract address |
taker | String | EOA that initiated the swap transaction, not the router/aggregator contract |
maker | String | Liquidity pool address that provided the other side of the trade |
project_contract_address | String | Pool or router contract address |
tx_hash | String | Transaction hash |
tx_from | String | Transaction sender (EOA) |
tx_to | String | Transaction recipient |
evt_index | UInt32 | Event log index in transaction |
agent.hyperevm_dex_trades
Enriched DEX swap events with token symbols, decimals, USD amounts, and protocol attribution. One row per swap event. Combines decoded events from all supported DEX protocols on this chain.
Engine: MergeTree | Partition: toYYYYMM(block_date) | ORDER BY: block_time, tx_hash, evt_index
| Column | Type | Description |
|---|---|---|
blockchain | String | Blockchain network name |
project | String | Protocol name (lowercase): uniswap, sushiswap, curve, pancakeswap, aerodrome, etc. |
version | String | Protocol version string: ‘1’, ‘2’, ‘3’, ‘v3’, ‘slipstream’, etc. |
block_month | Date | UTC block month (partition key) |
block_date | Date | Partition key. Always filter on this column for performance. |
block_time | DateTime64(3) | UTC block timestamp |
block_number | UInt64 | Block number |
token_bought_symbol | String | Symbol of token received |
token_sold_symbol | String | Symbol of token sent |
token_pair | String | Alphabetically sorted pair string (e.g., ‘ETH-USDC’). Useful for GROUP BY. |
token_bought_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_sold_amount | Float64 | Human-readable amount (divided by token decimals). Null if decimals unknown. |
token_bought_amount_raw | UInt256 | Raw token received amount (pre-decimal) |
token_sold_amount_raw | UInt256 | Raw token sent amount (pre-decimal) |
amount_usd | Nullable(Float64) | One-sided USD value of token_sold. Prices from CoinGecko hourly + DEX VWAP. Null for unpriced tokens. |
token_bought_address | String | Bought token contract address |
token_sold_address | String | Sold token contract address |
taker | String | EOA that initiated the swap transaction, not the router/aggregator contract |
maker | Nullable(String) | Liquidity pool address that provided the other side of the trade |
project_contract_address | String | Pool or router contract address |
tx_hash | String | Transaction hash |
tx_from | String | Transaction sender (EOA) |
tx_to | String | Transaction recipient |
evt_index | UInt32 | Event log index in transaction |