Liquidity Events

Availability

This collection is available for the Ethereum mainnet.
Points-of-Presence
Tables
eu-west-1
defi_trades_ethereum_mainnet_v1 defi_trades_polygon_mainnet_v1 defi_trades_arbitrum_mainnet_v1
us-east-1

Methodology

The table is built by extracting data from DEXes activity and then normalizing it to fit a unified data model.
We currently support the following DEXes:
  • Uniswap V2
  • Uniswap V3
  • Curve
We extract data from any contract compatible with one of the above DEXes ABI.
It means that any DEXes that forked or tried to be compatible at the ABI level with these contracts will be indexed automatically.

Table Schema

Column Name
Column Type
Description
chain_name
string
Name of the chain (ethereum, arbitrum, polygon, ...).
chain_network_name
string
name of the network (mainnet).
block_hash
string
Block hash encoded as binary string
block_number
uint64
Block height
transaction_index
uint64
The index of the transaction in the block
timestamp
datetime
UNIX timestamp for when the block was collated
decoder_name
string
The internal name of the decoder used to decode this trade (uniswap_v2_liquidity_event, curve_liquidity_event)
type
string
Either mint or burn
factory
string
The address of the DEX factory contract (if any)
contract
string
The address of the DEX pair/pool
provider
string
The address of the account that provided or withdraw the liquidity
raw_amounts
map(string, uint256)
A map of token amounts provided or withdrawn
amounts
map(string, float64)
A map of token amounts provided or withdrawn. The amount of tokens are divided by pow(10, decimals) where decimals is the number of decimals declared by the token (USDT has 6 decimals)

Usage

The query below makes use of the defi_liquidity_events_ethereum_mainnet_v1 to chart the daily delta of liquidity for each token of the famous Curve 3Pool (0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7).
select
date_trunc('day', timestamp) as date,
sum(if(type = 'mint', amounts['0x6b175474e89094c44da98b954eedeac495271d0f'], -amounts['0x6b175474e89094c44da98b954eedeac495271d0f'])) as delta_dai,
sum(if(type = 'mint', amounts['0xdac17f958d2ee523a2206206994597c13d831ec7'], -amounts['0xdac17f958d2ee523a2206206994597c13d831ec7'])) as delta_usdt,
sum(if(type = 'mint', amounts['0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'], -amounts['0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'])) as delta_usdc
from defi_liquidity_events_ethereum_mainnet_v1
where contract = '0xbEbc44782C7dB0a1A60Cb6fe97d0b483032FF1C7'
and timestamp >= now() - interval 30 day
group by date