Pools & Liquidity

This page covers Cubes for DEX pool and liquidity analysis:

DEXPoolEvents (DWD) — liquidity add/remove events with per-event reserves and prices
DEXPools (DWS) — pool snapshots (current liquidity and prices, refreshed periodically)
TokenSupplyUpdates (DWD) — token supply, market cap, and FDV updates

Examples use the Solana and EVM Chain Groups: Solana { ... } for Solana, EVM(network: eth | bsc | polygon) { ... } for EVM chains (including Polygon).

How do I get liquidity pools for a token?

Find DEX pools that list a token as token A in the snapshot. Pools where the asset appears only as token B need a second query with tokenB (or a where clause); for event-level rows with full pair context, use DEXPoolEvents.

query {
  Solana {
    DEXPools(
      limit: {count: 10}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool {
        Address
        ProgramAddress
        TokenAAddress
        TokenBAddress
        LiquidityUSD
        PriceAtoB
        PriceBtoA
        LastUpdated
      }
    }
  }
}

Open in GraphQL IDE — paste the query above to run it interactively with auto-complete and schema exploration.

Replace TOKEN_ADDRESS with the token mint (Solana) or contract address (EVM). Repeat with tokenB: {is: "TOKEN_ADDRESS"} to include pools where the token is the quote side.

Key fields

Field	Description
`Pool.Address`	Liquidity pool / market address
`Pool.ProgramAddress`	DEX program or factory address
`Pool.TokenAAddress`	Base-side token address
`Pool.TokenBAddress`	Quote-side token address
`Pool.LiquidityUSD`	Total pool liquidity in USD (snapshot)
`Pool.LastUpdated`	When this snapshot row was last updated

Customization tips

Filter by liquidity: Add where: {Pool: {LiquidityUSD: {gt: 10000}}} for pools above a USD depth threshold
Specific DEX: Add where: {Pool: {ProgramAddress: {is: "DEX_PROGRAM_OR_FACTORY_ADDRESS"}}}
More pools: Increase count to discover additional pools for the token
Per-event reserves: Use DEXPoolEvents with tokenAddress / poolAddress and orderBy: {descending: Block_Time} for add/remove history

How do I get details of a specific pool?

Read the latest snapshot for one pool by address. DEXPools does not expose a block timeline per row — use DEXPoolEvents for historical reserve series.

query {
  Solana {
    DEXPools(
      limit: {count: 1}
      poolAddress: {is: "POOL_ADDRESS"}
    ) {
      Pool {
        Address
        TokenAAddress
        TokenBAddress
        ProgramAddress
        LiquidityUSD
        PriceAtoB
        PriceBtoA
        LastUpdated
      }
    }
  }
}

Key fields

Field	Description
`Pool.TokenAAddress` / `Pool.TokenBAddress`	Pair token addresses
`Pool.LiquidityUSD`	Total liquidity in USD (snapshot)
`Pool.LastUpdated`	Last snapshot refresh for this pool

Customization tips

Reserve history: Query DEXPoolEvents with poolAddress: {is: "POOL_ADDRESS"} and orderBy: {descending: Block_Time}
Time range on events: On DEXPoolEvents, add where: {Block: {Time: {since: "2025-03-01T00:00:00Z"}}} to scope add/removes

The poolAddress selector filters by Pool.Address. It is available on DEXPools (snapshot) and DEXPoolEvents (events).

How do I rank pools or read snapshot liquidity?

DEXPools (DWS) stores current-state rows (typically refreshed every few minutes). Use it to rank pools by LiquidityUSD and compare DEX programs without scanning raw events.

query {
  Solana {
    DEXPools(
      limit: {count: 20}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool {
        Address
        ProgramAddress
        TokenAAddress
        TokenBAddress
        LiquidityUSD
        LastUpdated
      }
    }
  }
}

Key fields

Field	Description
`Pool.Address`	Pool address
`Pool.ProgramAddress`	DEX program / factory
`Pool.TokenAAddress` / `Pool.TokenBAddress`	Pair tokens
`Pool.LiquidityUSD`	Snapshot liquidity in USD
`Pool.LastUpdated`	How fresh the snapshot is

Customization tips

Rank by liquidity: Sort client-side by LiquidityUSD, or use orderBy if your schema exposes a pool snapshot ordering
Active pools: Prefer pools with recent LastUpdated
Compare DEXes: Group or filter by Pool.ProgramAddress

DEXPoolEvents (DWD) is the right Cube for time series of reserves and every liquidity event. DEXPools (DWS) is optimized for latest pool state and discovery.

How do I get token supply and market cap?

Use TokenSupplyUpdates for supply, market cap, price, and FDV tied to supply events.

query {
  Solana {
    TokenSupplyUpdates(
      limit: {count: 1}
      tokenAddress: {is: "TOKEN_ADDRESS"}
      orderBy: {descending: Block_Time}
    ) {
      TokenSupplyUpdate {
        Currency { MintAddress, Decimals }
        PostBalance
        MarketCapInUSD
        PriceInUSD
        FDVInUSD
        TotalSupply
      }
      Block { Time }
    }
  }
}

Key fields

Field	Description
`TokenSupplyUpdate.Currency.MintAddress`	Token address
`TokenSupplyUpdate.Currency.Decimals`	Token decimals
`TokenSupplyUpdate.PostBalance`	Current supply after the event
`TokenSupplyUpdate.MarketCapInUSD`	Market capitalization in USD
`TokenSupplyUpdate.PriceInUSD`	Token price at the time of the supply event
`TokenSupplyUpdate.FDVInUSD`	Fully diluted valuation
`TokenSupplyUpdate.TotalSupply`	Total token supply

Customization tips

Supply history: Increase count to see how supply changed over time (mint/burn events)
Market cap history: Query multiple supply updates to chart market cap over time
Combined with price: Use PriceInUSD alongside TotalSupply to verify market cap calculations

This page uses TokenSupplyUpdates for supply-linked market cap, price, and FDV. For additional token metrics and summaries, see OHLC & Statistics.

Multi-Chain Examples

Solana
Ethereum
BSC
Polygon

query {
  Solana {
    DEXPools(
      limit: {count: 5}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool { Address, LiquidityUSD, LastUpdated }
    }
  }
}

query {
  EVM(network: eth) {
    DEXPools(
      limit: {count: 5}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool { Address, LiquidityUSD, LastUpdated }
    }
  }
}

query {
  EVM(network: bsc) {
    DEXPools(
      limit: {count: 5}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool { Address, LiquidityUSD, LastUpdated }
    }
  }
}

query {
  EVM(network: polygon) {
    DEXPools(
      limit: {count: 5}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool { Address, LiquidityUSD, LastUpdated }
    }
  }
}

Next Steps

DEX Trades

Query DEX trading data — token trades, wallet activity, and top traders.

Transfers

Track on-chain token transfers between wallets.

Balances & Holders

Look up wallet balances, balance history, and top holders.

OHLC & Statistics

Fetch candlestick data, trade stats, market cap, and token metadata.

Getting Started

GraphQL IDE

Schema & Data Model

Query Examples

Billing & Credits

How do I get liquidity pools for a token?

How do I get details of a specific pool?

How do I rank pools or read snapshot liquidity?

How do I get token supply and market cap?

Multi-Chain Examples

Next Steps

DEX Trades

Transfers

Balances & Holders

OHLC & Statistics

​How do I get liquidity pools for a token?

​How do I get details of a specific pool?

​How do I rank pools or read snapshot liquidity?

​How do I get token supply and market cap?

​Multi-Chain Examples

​Next Steps

DEX Trades

Transfers

Balances & Holders

OHLC & Statistics

How do I get liquidity pools for a token?

How do I get details of a specific pool?

How do I rank pools or read snapshot liquidity?

How do I get token supply and market cap?

Multi-Chain Examples

Next Steps