# Compare Pools

> Compare all Uniswap pools for a token pair across fee tiers and versions. Use when the user asks which pool is best, wants to compare V3 vs V4, or wants to find the optimal fee tier.

- Skill: `johnalbertini14-glitch/compare-pools` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add johnalbertini14-glitch/compare-pools`
- Raw SKILL.md: https://api.skillmd.com/api/skills/johnalbertini14-glitch/compare-pools/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: johnalbertini14-glitch (https://skillmd.com/u/johnalbertini14-glitch)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/johnalbertini14-glitch/compare-pools

---


# Compare Pools

## Overview

Compares all available Uniswap pools for a token pair across fee tiers (1bp, 5bp, 30bp, 100bp) and protocol versions (V2, V3, V4). Delegates to `pool-researcher` in comparison mode to rank pools by APY, liquidity depth, and utilization.

## When to Use

Activate when the user asks:

- "Compare ETH/USDC pools"
- "Which pool is best for ETH/USDC?"
- "V3 vs V4 for this pair"
- "Best fee tier for WETH/USDC"
- "Which fee tier has the best APY?"
- "Compare liquidity across fee tiers"

## Parameters

| Parameter | Required | Default     | Description                                    |
| --------- | -------- | ----------- | ---------------------------------------------- |
| token0    | Yes      | —           | First token name, symbol, or address           |
| token1    | Yes      | —           | Second token name, symbol, or address          |
| chain     | No       | All chains  | Chain name or "all" for cross-chain comparison |
| compareBy | No       | all         | Focus: "tvl", "volume", "apy", or "all"        |

## Workflow

1. **Extract parameters** from the user's request.

2. **Delegate to pool-researcher**: Invoke `Task(subagent_type:pool-researcher)` asking for a comparison of all pools for the token pair. The agent will discover pools across fee tiers and versions, gather data for each, and rank them.

3. **Present comparison**: Format as a comparison table with a clear recommendation.

## Output Format

```text
Pool Comparison: WETH/USDC (Ethereum)

  | Pool       | Fee    | TVL     | Vol 24h  | APY 7d | Depth 1% | Recommended |
  | ---------- | ------ | ------- | -------- | ------ | -------- | ----------- |
  | V3 0.05%   | 5bp    | $332M   | $610M    | 21.3%  | $5M      | Best APY    |
  | V3 0.30%   | 30bp   | $85M    | $45M     | 8.2%   | $2M      |             |
  | V3 1.00%   | 100bp  | $12M    | $3M      | 4.1%   | $500K    |             |
  | V2 0.30%   | 30bp   | $25M    | $8M      | 3.5%   | $1M      |             |

  Recommendation: V3 0.05% pool — highest APY with deepest liquidity.
```

## Important Notes

- Delegates to `pool-researcher` — no direct MCP tool calls.
- Pools with zero liquidity or no activity are excluded from comparison.
- Ranking considers multiple factors: APY, depth, stability, and utilization.

## Error Handling

| Error              | User-Facing Message                        | Suggested Action                |
| ------------------ | ------------------------------------------ | ------------------------------- |
| No pools found     | "No active pools found for X/Y."           | Check token names or try another chain |
| Single pool only   | "Only one pool exists for X/Y."            | Shows single pool analysis instead     |