Skip to content

Dex Liquidity

The base.dex_liquidity table provides indexed views of all DEX liquidity for the chain. All DEX liquidity tables follows the same database schema presented below.

Columns

Name Type Description
block_number integer The block number at which the event occurred.
category text The category of the event, one of (deposit, withdraw, or swap).
contract_address text The contract address of the DEX pool.
contract_version text The version of the exchange contract interacted with (e.g. v1 or v2).
exchange_name text The name of the exchange that facilitated the event.
liquidity numeric The total pool liquidity between the tick range post transaction (only Uniswap V3 and Kyber V3).
liquidity_delta numeric The change in the liquidity in the tick range (only Uniswap V3 and Kyber V3).
log_index integer The log index at which the event occurred.
lp_address text The address of the liquidity provider (null for swap events).
pool_balance numeric The DEX Pool's balance of token_address
position_id integer Unique position NFT ID for the tick range (only Uniswap V3 and Kyber V3).
position_liquidity numeric The total position liquidity for position_id post transaction (only Uniswap V3 and Kyber V3).
quantity numeric The quantity of the token_address (negative for withdrawals, swaps out).
sender_address text The address that initiated the event.
tick_lower numeric The bottom of the tick range (only Uniswap V3 and Kyber V3).
tick_upper numeric The top of the tick range (only Uniswap V3 and Kyber V3).
timestamp timestamp without time zone The timestamp at which the event occurred.
token_address text The token address whose pool balance was affected in the liquidity event.
transaction_hash text The transaction hash at which the event occurred.
__block_number integer The block number at which the event took place in.
__confirmed boolean Flag indicating whether the transfer has been confirmed.
__last_modified timestamp The date at which this row was last updated (in ISO-8601 format).

Supported Protocols

Protocol
balancer-v2 baseswap-v2 crescentswap-v3 dackle-v3
damaswap-v2 friend-tech-v1 horizen-v3 leetswap-v2
oasisswap-v2 rocketswap-v2 solidly-v1-forks sushiswap-v3
synapse-v1 uniswap-v2-forks uniswap-v3 uniswap-v3-forks
yumyumswap-v3

Indexes

Index
position_id, timestamp, log_index
contract_address, position_id, timestamp, log_index
exchange_name, contract_version, timestamp, log_index
exchange_name, timestamp, log_index
lp_address, contract_address, timestamp, log_index
lp_address, token_address, timestamp, log_index
lp_address, timestamp, log_index
token_address, contract_address, timestamp, log_index
contract_address, timestamp, log_index
token_address, timestamp, log_index
timestamp, log_index
transaction_hash, log_index
__last_modified
__indexer_id WHERE __confirmed = false
__indexer_id, __block_number
contract_address, token_address, block_number, log_index

Got questions? Join our Discord

Discord is the primary home of the Transpose developer community. Join us to ask questions, share your work, and get help.