Skip to main content

Overview

  • Dataset ID: 0211
  • Table: blockdb_evm.b0211_liquidity_pools_v1
  • Description: Canonical list of pools; child time-series tables FK to blockdb_evm.b0211_liquidity_pools_v1(pool_uid).
  • Primary Key: pool_uid
  • API: POST /evm/pools

Columns

ColumnTypeDescription
pool_uidBYTEAStable surrogate key derived from address or pool_id (used across datasets).
exchange_idINTEGERExchange identifier (e.g., 1 for Uniswap, 2 for Sushiswap, etc.).
type_idINTEGERPool type identifier (e.g. 201 for Uniswap V2, 301 for Uniswap V3).
block_numberBIGINTBlock number where pool was first recognized/derived.
block_timeTIMESTAMPTZUTC timestamp for the block that produced this record.
tx_indexINTEGERZero-based transaction index within the block.
log_indexINTEGERZero-based log index within the transaction.
factoryBYTEAFactory/pool-manager contract address.
tokensBYTEA[]Array of token addresses that compose the pool, ordered as stored on-chain.
contract_addressBYTEA20B address for v2/v3-style pools (nullable for id-only v4).
pool_idBYTEA32B identifier for v4-style pools (nullable for v2/v3).
pairnumNUMERIC(6)Internal index representing the slot/order of the token pair within the pool.
asset_managersBYTEA[]Optional array of asset manager addresses for Balancer-style custodial pools.
ampNUMERIC(6)Amplification coefficient for stable or hybrid pools (NULL for constant product pools).
weightsNUMERIC(6,5)[]Array of normalized token weights for weighted pools (e.g., Balancer).
tick_spacingSMALLINTTick spacing parameter for concentrated liquidity pools.
_tracing_idBYTEABlockDB lineage identifier that links this record to lineage APIs.
_parent_tracing_idsBYTEA[]Tracing identifiers for upstream derived records referenced during computation.
_created_atTIMESTAMPTZRecord creation timestamp.
_updated_atTIMESTAMPTZRecord last update timestamp.

Use Cases

  • Building the complete DEX pool registry for routing and analytics
  • Filtering pools by fee, type, or token pair
  • Integrating with reserves, price, and swap datasets for liquidity intelligence
  • MEV routing, arbitrage path optimization, and chain-wide pool analytics
  • Constructing pool-level AI or quantitative features