All packages
uniswap_v3_pool_data

uniswap_v3_pool_data

johnangwin
v0.1.2/27 downloads

Package ref

uniswap-v3-pool-data@v0.1.2

Run package

Start block
0, the module's first block

This module reads a store, which starts empty at the module's first block: it runs from there, so its output is from then, not from the chain head. Any later block would first need the store rebuilt up to it.

README

Uniswap V3 Pool Liquidity Tracker

This substreams package tracks liquidity changes in Uniswap V3 pools in real-time.

Features

  • Real-time liquidity snapshots
  • Configurable snapshot intervals
  • Multi-network support (Ethereum, Arbitrum, Base, Polygon)
  • USD value calculations

Usage

substreams run pool_liquidity \
  --start-block 18000000 \
  --stop-block 18001000 \
  -p "pool_address=0x88e6A0c2dDD26FeeB64F039a2c41296FcB3f5640&snapshot_interval=3600"

Parameters

  • pool_address: Uniswap V3 pool contract address
  • snapshot_interval: Snapshot interval in seconds (e.g., 3600 for hourly)
  • min_liquidity_usd: Minimum liquidity threshold in USD (optional)

Output

Returns LiquiditySnapshot protobuf messages containing:

  • Block number and timestamp
  • Pool address
  • Total liquidity amounts
  • Token-specific liquidity
  • USD volume equivalent

Modules

Execution graph

3 modules