リクイディティプール分析

概要

DEXのリクイディティプールを分析し、TVL、取引高、手数料収入、無常損失リスクを理解します。複数のプロトコル(Uniswap、Curve、Balancer)およびチェーン間でプールを比較し、最適なLPの機会を特定します。

前提条件

このスキルを使用する前に、以下が必要です:

• Python 3.8以上がインストールされていること
• サブグラフ/APIクエリのためのインターネット接続
• リクイディティ提供の概念(IL、手数料階層、TVL)の理解

操作手順

ステップ1: 特定のプールを分析する

アドレスでプールを分析:

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

トークンペアで分析:

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

ステップ2: 無常損失を計算する

価格変動のILを計算:

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

様々なシナリオでILを予測:

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

ステップ3: LP リターンを見積もる

手数料APRを計算:

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

ポジションサイズのリターンを予測:

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

ステップ4: プールを比較する

複数プロトコル間で同じペアを比較:

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

手数料階層を比較:

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

ステップ5: 結果をエクスポートする

JSONにエクスポート:

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

比較結果をCSVにエクスポート:

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

出力

プール分析サマリー

==============================================================================
  LIQUIDITY POOL ANALYZER                           2026-01-15 15:30 UTC
==============================================================================

  POOL: USDC/WETH (Uniswap V3 - 0.05%)
------------------------------------------------------------------------------
  Chain:          Ethereum
  TVL:            $500.5M
  24h Volume:     $125.3M
  Fee Tier:       0.05%

  FEE METRICS
------------------------------------------------------------------------------
  24h Fees:       $62,650
  Fee APR:        4.57%
  Volume/TVL:     0.25

  TOKEN COMPOSITION
------------------------------------------------------------------------------
  USDC:           $252.1M (50.4%)
  WETH:           $248.4M (49.6%)
  Current Price:  $2,450/ETH
==============================================================================

無常損失レポート

  IMPERMANENT LOSS CALCULATION
------------------------------------------------------------------------------
  Entry Price:    $2,000/ETH
  Current Price:  $3,000/ETH
  Price Change:   +50%

  IL (%)          -5.72%
  IL ($1000 LP):  -$57.20

  Value if HODL:  $1,250.00
  Value in LP:    $1,192.80

  BREAKEVEN ANALYSIS (0.05% fee tier)
------------------------------------------------------------------------------
  Daily Fees:     $0.63 (at $500M TVL, $125M vol)
  Days to Break:  91 days
  Monthly Fees:   $18.90
==============================================================================

エラーハンドリング

包括的なエラーハンドリングについては、{baseDir}/references/errors.md を参照してください。

一般的な問題:

• プールが見つからない: アドレスとチェーンを確認してください
• サブグラフタイムアウト: キャッシュされたデータを警告付きで使用します
• 無効なペア: サポートされているプロトコルを確認してください

例

詳細な使用例については、{baseDir}/references/examples.md を参照してください。

クイック例

トップETH/USDCプールを分析:

python pool_analyzer.py --pair ETH/USDC --protocol uniswap-v3 --chain ethereum

2倍の価格上昇のILを計算:

python pool_analyzer.py --il-calc --entry-price 100 --current-price 200

Uniswap手数料階層を比較:

python pool_analyzer.py --compare --pair ETH/USDC --fee-tiers 0.05,0.30,1.00

すべてのETHペアをエクスポート:

python pool_analyzer.py --token ETH --format json --output eth_pools.json

設定

{baseDir}/config/settings.yaml での設定:

• デフォルトチェーン: クエリする主要チェーン
• キャッシュTTL: サブグラフデータをキャッシュする期間
• サブグラフエンドポイント: 各プロトコルのURL
• 手数料階層デフォルト: 一般的な手数料階層オプション

リソース

• The Graph: https://thegraph.com/ - サブグラフクエリ
• Uniswap Info: https://info.uniswap.org/ - プール エクスプローラー
• DeFiLlama: https://defillama.com/ - TVLデータ
• Impermanent Loss Calculator: https://dailydefi.org/tools/impermanent-loss-calculator/