Pools

Find liquidity pools for a given trading pair across supported networks.

Method

client.pools.find(
    symbol: str
) -> Response

Example: Get DataFrame

You can fetch all discovered pools into a DataFrame to easily compare liquidity and volume.

import qoery

client = qoery.Client()

# Find pools for WETH-USDC
pools = client.pools.find(symbol="WETH-USDC")

# Convert to DataFrame
df = pools.df

# Filter for pools with > $1M TVL
major_pools = df[df['tvl_usd'].astype(float) > 1_000_000]

print(major_pools[['network', 'fee_tier', 'tvl_usd']])

Output:

    network fee_tier      tvl_usd
0  ethereum      500  25000000.00
1  arbitrum      500   5000000.00
...

Example: Iterate Objects

pools = client.pools.find(symbol="WETH-USDC")

for pool in pools:
    print(f"{pool.network} ({pool.fee_tier}): {pool.id}")

Parameters