Skip to main content

Overview

  • Dataset ID: 0203
  • Table: blockdb0203_liquidity_pools_v1
  • Description: Canonical list of pools; child time-series tables FK to blockdb0203_liquidity_pools_v1(id).

Columns

ColumnTypeDescription
uidBIGINTStable surrogate identifier for each liquidity pool (used across datasets).
block_numberBIGINTCanonical block height within the originating chain.
block_timeTIMESTAMPTZUTC timestamp for the block that produced this record.
tx_indexINTEGERZero-based transaction index within the block, used for deterministic ordering.
log_indexINTEGERZero-based log index within the transaction, uniquely identifying the emitted event.
contract_addressBYTEA20B address for v2/v3-style pools (nullable for id-only v4).
pool_idBYTEA32B identifier for v4-style pools (nullable for v2/v3).
factoryBYTEAAddress of the factory contract that deployed the pool.
type_idINTEGERForeign key into blockdb0002_liquidity_pools_types_v1 describing the pool class.
pairnumNUMERIC(6)Internal index representing the slot/order of the token pair within the pool.
tokensBYTEA[]Array of token addresses that compose the pool, ordered as stored on-chain.
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 controlling price granularity for concentrated liquidity pools.
_tracing_idBYTEABlockDB lineage identifier that links this record to lineage APIs.
_genesis_tracing_idsBYTEA[]Tracing identifiers for the raw artifacts (blocks, logs, proofs) that seeded this record.
_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