On-Chain Data: DEX Liquidity Pool Forensics

Analyzing liquidity pools across a range of DeFi protocols is a difficult endeavor for researchers and other crypto market participants. Sourcing accurate data from which you can draw actionable insights presents several challenges. The sheer quantity of data alone is a challenge, since analyzing liquidity pools requires high quality historical and real-time pool transaction data. In addition, several key data points can be especially tricky - for example, calculating an individual token’s composition of a pool and sourcing an accurate count of liquidity providers in a pool. These challenges are compounded when one tries to monitor multiple pools.
At expand.network, we have created a series of endpoints to solve this challenging issue and make monitoring liquidity pool composition and on-going transactions accessible for users. Some examples of uses for this data include blockchain analytics firms looking to analyze pools and monitor movements and researchers looking to understand pool dynamics and assess risk.

expand.network’s Liquidity Forensics Endpoints

  • Address Analysis: The“getpoolindividualliquidity” returns all user addresses, block numbers, and token position details for a specified pool address. This can be used to accurately identify the public addresses associated with liquidity contributions.
  • Pool Liquidity: The “getpoolliquidity” endpoint returns the total liquidity for a specified pool.
  • Token Liquidity: The “gettokenliquidity” endpoint allows users to source the individual token liquidity within a specified liquidity pool.
  • Holder Enumeration: The“getliquidityholders” endpoint returns the total number of liquidity providers in a specified liquidity pool, allowing users to easily source a key metric for assessing the health of a liquidity pool.
  • Management Across Pools: For those looking to understand address dynamics across multiple pools, the “getindividualposition” endpoint will return the liquidity position for a specified user address across all the pools of a specified DEX.
  • Token Pair Liquidity: The “getuserliquidity” endpoint returns the balance of a specified token pair for a specified address.
  • Aggregated DEX Quotes: The “quoteaggregator” endpoint returns quotes for a specific pair address from various DEXs and DEX aggregators in which the pair address is present.
  • Token Pair Swap Quote: The “getprice” endpoint returns the swap quotation for a specified token pair for a specified DEX.


  1. 1.
    Automated Pool Management: In conjunction with the expand.network API's transacting capabilities, you can source data to reliably automate pool management operations.
  2. 2.
    Real-time Insights: Users can monitor real-time pool dynamics to support risk management and trading decisions.
  3. 3.
    Historical Analysis: Source extensive historical data to analyze liquidity trends and pool dynamics, and refine liquidity provisioning strategies.
  4. 4.
    Portfolio Management: Track liquidity pool positions across multiple pools and at various periods of time to accurately value portfolios.
  5. 5.
    Custom Reporting and Notifications: Users can create customized reports on pool performance and receive notifications for important events, such as significant liquidity changes.