DEX Trades

Enriched swap events across 6 chains with token symbols, USD amounts, and protocol attribution.

6 tables — one per chain, identical schema.

TableChainNotable
agent.ethereum_dex_tradesEthereumMost DEX diversity
agent.base_dex_tradesBaseAerodrome-heavy
agent.arbitrum_dex_tradesArbitrumGMX, Camelot
agent.bsc_dex_tradesBSCLargest table (~4B rows), PancakeSwap-dominant
agent.tron_dex_tradesTronSunSwap-dominant, base58 addresses
agent.hyperevm_dex_tradesHyperEVMNewest chain, thinner coverage

Schema

All 6 tables share this schema. Minor type differences noted where applicable.

Engine: MergeTree | Partition: toYYYYMM(block_date) | ORDER BY: block_time, tx_hash, evt_index

ColumnTypeDescription
blockchainStringChain name
projectStringProtocol (lowercase): uniswap, sushiswap, curve, pancakeswap, aerodrome, etc.
versionStringProtocol version: '1', '2', '3', 'v3', 'slipstream'
block_dateDatePartition key — always filter on this
block_timeDateTime64(3)UTC timestamp
block_numberUInt64
token_bought_symbolNullable(String)Token received
token_sold_symbolNullable(String)Token sent
token_pairStringAlphabetically sorted pair (e.g., 'ETH-USDC')
token_bought_amountFloat64Human-readable (decimal-adjusted)
token_sold_amountFloat64Human-readable (decimal-adjusted)
token_bought_amount_rawUInt256Raw pre-decimal amount
token_sold_amount_rawUInt256Raw pre-decimal amount
amount_usdNullable(Float64)One-sided USD value (token_sold). Null for unpriced tokens.
token_bought_addressStringContract address
token_sold_addressStringContract address
takerStringEOA that initiated the swap (not the router)
makerNullable(String)Liquidity pool address
project_contract_addressStringPool or router contract
tx_hashStringTransaction hash
tx_fromStringTransaction sender
tx_toStringTransaction recipient
evt_indexUInt32Event log index

Good to Know

  • amount_usd is one-sided (token_sold value). Multiply by 2 for two-sided volume.
  • taker is the EOA, not the router/aggregator contract.
  • token_pair is alphabetically sorted — always 'ETH-USDC', never 'USDC-ETH'.
  • No aggregator attribution — a 1inch-routed swap shows as the underlying DEX.
  • USD prices from CoinGecko hourly — new/illiquid tokens may have null amount_usd.
  • Does not include limit orders, RFQ fills, or off-chain matching.