mcpField
A
analyzing-liquidity-pools

analyzing-liquidity-pools

github.com/jeremylongshore数据与数据库2.9k47 次安装2 天前更新
代码仓库

关于 analyzing-liquidity-pools

analyzing-liquidity-pools 是用于评估 DEX 流动性池的分析技能,适合比较 Uniswap、Curve 和 Balancer 的池与费率。它提供 TVL、交易量、费用收益及无常损失分析,并可导出结果。

主要功能

  1. 01分析 TVL、交易量与费用收益
  2. 02计算无常损失及盈亏平衡
  3. 03估算 LP 收益与仓位表现
  4. 04比较协议和费率档位
  5. 05导出 JSON 或 CSV

适用场景

  1. 01评估特定交易对的流动性池
  2. 02比较不同协议或费率档位
  3. 03测算价格变动下的无常损失
  4. 04导出池数据供后续分析

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill analyzing-liquidity-pools

安装后在 Claude Code 中输入/analyzing-liquidity-pools确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

ARD.md
PRD.md
config/
settings.yaml
references/
errors.md
examples.md
implementation.md
scripts/
formatters.py
il_calculator.py
pool_analyzer.py
pool_fetcher.py
pool_metrics.py

详细介绍

分析流动性池

概述

分析 Uniswap、Curve 和 Balancer 上的 DEX 流动性池,评估 TVL、交易量、手续费收入和无常损失风险。比较不同协议和链上的流动性池,找出理想的 LP 机会。

前提条件

  • 已安装 Python 3.8+
  • 可访问互联网,以查询子图/API
  • 了解提供流动性的相关概念(IL、手续费等级、TVL)

说明

  1. 按地址或代币对分析特定流动性池:

    python ${CLAUDE_SKILL_DIR}/scripts/pool_analyzer.py --pool 0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640
    python ${CLAUDE_SKILL_DIR}/scripts/pool_analyzer.py --pair ETH/USDC --protocol uniswap-v3
    
  2. 计算价格变动时的无常损失:

    python ${CLAUDE_SKILL_DIR}/scripts/pool_analyzer.py --il-calc --entry-price 2000 --current-price 3000  # 2000/3000 = ETH price at entry/now in USD
    

    预测不同情景下的 IL:

    python ${CLAUDE_SKILL_DIR}/scripts/pool_analyzer.py --il-scenarios --token-pair ETH/USDC
    
  3. 估算 LP 回报,包括手续费 APR 和仓位预测:

    python ${CLAUDE_SKILL_DIR}/scripts/pool_analyzer.py --pool [address] --detailed
    python ${CLAUDE_SKILL_DIR}/scripts/pool_analyzer.py --pool [address] --position 10000  # 10000 = LP position size in USD
    
  4. 比较不同协议或手续费等级的流动性池:

    python ${CLAUDE_SKILL_DIR}/scripts/pool_analyzer.py --compare --pair ETH/USDC --protocols uniswap-v3,curve,balancer
    python ${CLAUDE_SKILL_DIR}/scripts/pool_analyzer.py --compare --pair ETH/USDC --fee-tiers 0.05,0.30,1.00
    
  5. 将结果导出为 JSON 或 CSV:

    python ${CLAUDE_SKILL_DIR}/scripts/pool_analyzer.py --pool [address] --format json --output pool_analysis.json
    python ${CLAUDE_SKILL_DIR}/scripts/pool_analyzer.py --compare --pair ETH/USDC --format csv --output pools.csv
    

输出

流动性池分析报告包括链、TVL、24 小时交易量、手续费等级、手续费 APR、交易量/TVL 比率,以及带有当前价格的代币构成。无常损失报告显示 IL 百分比、美元影响、持有与 LP 价值对比,以及根据手续费收入计算的盈亏平衡分析和所需天数。

有关详细的输出格式示例,请参阅 ${CLAUDE_SKILL_DIR}/references/implementation.md。

错误处理

错误原因解决方法
未找到流动性池地址或链错误验证地址和目标链
子图超时API 延迟或停机使用缓存数据并显示警告
交易对无效不支持的协议查看支持的协议列表

示例

分析排名靠前的 ETH/USDC 流动性池 - 查看 Uniswap V3 上完整的 TVL、交易量和手续费明细:

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  # 100/200 = token price at entry/now in USD

比较 Uniswap 手续费等级 - 找出 ETH/USDC 的理想手续费等级:

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

资源

评论

支持 Markdown