Uniswap Pool Analysis

Analyze Uniswap pool data including liquidity distribution, fee tiers, tick ranges, and TVL. Use when the user asks about pool metrics, liquidity analysis, or wants to query on-chain pool state.

Overview

This skill covers querying and analyzing Uniswap v3/v4 pool state on-chain using viem.

Key Concepts

• sqrtPriceX96: Encoded price format used by Uniswap v3/v4. Convert with price = (sqrtPriceX96 / 2^96)^2
• Ticks: Discrete price points defining liquidity ranges. Tick spacing depends on fee tier.
• Liquidity: The L value representing active liquidity at the current tick.

Fee Tiers (v3)

Fee (bps)	Tick Spacing	Typical Use
1 (0.01%)	1	Stablecoin pairs
5 (0.05%)	10	Correlated pairs
30 (0.30%)	60	Standard pairs
100 (1.00%)	200	Exotic pairs

Querying Pool State

Use the Uniswap v3 Pool ABI to read on-chain state:

typescript

import { createPublicClient, http } from "viem";
import { mainnet } from "viem/chains";

const client = createPublicClient({
  chain: mainnet,
  transport: http(process.env.ETHEREUM_RPC_URL),
});

// Read slot0 for current price and tick
const [
  sqrtPriceX96,
  tick,
  observationIndex,
  observationCardinality,
  observationCardinalityNext,
  feeProtocol,
  unlocked,
] = await client.readContract({
  address: poolAddress,
  abi: poolAbi,
  functionName: "slot0",
});

// Read liquidity
const liquidity = await client.readContract({
  address: poolAddress,
  abi: poolAbi,
  functionName: "liquidity",
});

Price Conversion

typescript

function sqrtPriceX96ToPrice(
  sqrtPriceX96: bigint,
  decimals0: number,
  decimals1: number,
): number {
  const price = Number(sqrtPriceX96) / 2 ** 96;
  return (price * price * 10 ** decimals0) / 10 ** decimals1;
}

function tickToPrice(
  tick: number,
  decimals0: number,
  decimals1: number,
): number {
  return (1.0001 ** tick * 10 ** decimals0) / 10 ** decimals1;
}

Liquidity Distribution

To analyze liquidity distribution across ticks:

1. Query tickBitmap to find initialized ticks
2. For each initialized tick, read ticks(tickIndex) to get liquidityNet
3. Walk from MIN_TICK to MAX_TICK, accumulating net liquidity changes
4. Plot cumulative liquidity vs price for the distribution

Multi-chain Support

Always accept a chainId parameter. Use the shared chain config from packages/common/ to resolve:

• RPC URL
• Pool factory address
• Quoter address
• Subgraph endpoint (if available)