analyzing-liquidity-pools

# Analyzing Liquidity Pools

## Overview

Analyze DEX liquidity pools to understand TVL, trading volume, fee income, and impermanent loss risk. Compare pools across protocols (Uniswap, Curve, Balancer) and chains to identify optimal LP opportunities.

## Prerequisites

Before using this skill, ensure you have:

- Python 3.8+ installed
- Internet access for subgraph/API queries
- Understanding of liquidity providing concepts (IL, fee tiers, TVL)

## Instructions

### Step 1: Analyze a Specific Pool

Analyze pool by address:

```bash
python {baseDir}/scripts/pool_analyzer.py --pool 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640
```

Analyze by token pair:

```bash
python {baseDir}/scripts/pool_analyzer.py --pair ETH/USDC --protocol uniswap-v3
```

### Step 2: Calculate Impermanent Loss

Calculate IL for a price change:

```bash
python {baseDir}/scripts/pool_analyzer.py --il-calc --entry-price 2000 --current-price 3000
```

Project IL for various scenarios:

```bash
python {baseDir}/scripts/pool_analyzer.py --il-scenarios --token-pair ETH/USDC
```

### Step 3: Estimate LP Returns

Calculate fee APR:

```bash
python {baseDir}/scripts/pool_analyzer.py --pool [address] --detailed
```

Project returns for position size:

```bash
python {baseDir}/scripts/pool_analyzer.py --pool [address] --position 10000
```

### Step 4: Compare Pools

Compare same pair across protocols:

```bash
python {baseDir}/scripts/pool_analyzer.py --compare --pair ETH/USDC --protocols uniswap-v3,curve,balancer
```

Compare fee tiers:

```bash
python {baseDir}/scripts/pool_analyzer.py --compare --pair ETH/USDC --fee-tiers 0.05,0.30,1.00
```

### Step 5: Export Results

Export to JSON:

```bash
python {baseDir}/scripts/pool_analyzer.py --pool [address] --format json --output pool_analysis.json
```

Export comparison to CSV:

```bash
python {baseDir}/scripts/pool_analyzer.py --compare --pair ETH/USDC --format csv --output pools.csv
```

## Output

### Pool Analysis Summary
```
==============================