uniswap-pool-analysis

name: uniswap-pool-analysis

description: 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.

Uniswap Pool Analysis

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:

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:

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)