Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.allium.so/llms.txt

Use this file to discover all available pages before exploring further.

The Pool Balance Changes Daily table contains one row per (liquidity pool, token, day) capturing the pool’s closing token reserve and its USD value. Use this table to track TVL trends, reserve imbalances, and pool composition over time.

Table Columns

Unique Key: block_date, liquidity_pool_address, token_address
Column NameData TypeDescription
block_dateTIMESTAMP_NTZ(9)The UTC date this daily pool balance snapshot covers
projectVARCHARName of the project (e.g. uniswap)
protocolVARCHARProtocol name (e.g. uniswap_v2, uniswap_v3)
pool_nameVARCHARHuman-readable pool name (typically token0/token1)
liquidity_pool_addressVARCHARContract address of the liquidity pool
token_addressVARCHARContract address of the token held in the pool
raw_balance_strVARCHARPool’s token reserve, unnormalized, as string for precision
raw_balanceFLOATPool’s token reserve, unnormalized
balance_strVARCHARPool’s token reserve, normalized, as string for precision
balanceFLOATPool’s token reserve, normalized by token decimals
usd_balanceFLOATUSD value of the pool’s reserve of this token
usd_exchange_rateFLOATExchange rate used for USD conversion
block_timestampTIMESTAMP_NTZ(9)Block timestamp at which the balance was captured
block_numberINTEGERBlock number at which the balance was captured