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)

Querying Pool State

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

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

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:

• Query tickBitmap to find initialized ticks
• For each initialized tick, read ticks(tickIndex) to get liquidityNet
• Walk from MIN_TICK to MAX_TICK, accumulating net liquidity changes
• 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)