mcpField
A
analyzing-on-chain-data

analyzing-on-chain-data

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

关于 analyzing-on-chain-data

通过 DeFiLlama 分析 DeFi 协议、链级 TVL、费用、DEX 交易量、收益机会和稳定币市值，适合研究人员、协议分析者和收益耕作者。提供命令行筛选与 JSON、CSV 导出，无需编写自定义 subgraph 查询。

主要功能

  1. 01按类别和区块链筛选协议数据
  2. 02查看协议及链级 TVL 排名
  3. 03查询费用、收入和 DEX 交易量
  4. 04按 TVL 与链筛选收益机会
  5. 05检测 TVL 变化并导出数据

适用场景

  1. 01汇总每日 DeFi 协议和链的 TVL
  2. 02研究借贷协议的费用与收入
  3. 03筛选特定链上满足 TVL 门槛的收益池

安装

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

$npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill analyzing-on-chain-data

安装后在 Claude Code 中输入/analyzing-on-chain-data确认已加载。

包含的文件

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

ARD.md
PRD.md
config/
settings.yaml
references/
errors.md
examples.md
implementation.md
scripts/
data_fetcher.py
formatters.py
metrics_calculator.py
onchain_analytics.py

详细介绍

分析链上数据

概述

使用 DeFiLlama 作为主要数据源，分析 DeFi 协议指标、链级 TVL、费用收入、DEX 交易量、收益机会和稳定币市值。专为需要通过程序访问链上分析数据、又不想编写自定义子图查询的 DeFi 研究人员、协议分析师和收益耕作者设计。

前置条件

  • 已安装 requests 库的 Python 3.8+
  • DeFiLlama API 访问权限（大多数端点免费且无需密钥）
  • 可选：CoinGecko API 密钥，用于补充代币价格数据
  • 插件目录中提供 onchain_analytics.py CLI 脚本
  • 用于编程调用的 data_fetcher.py 和 metrics_calculator.py 模块

操作说明

  1. 运行 python onchain_analytics.py protocols，获取按总锁仓价值（TVL）排名的 DeFi 协议。
  2. 使用 --category lending、--category dex 或 --category "liquid staking" 按类别筛选协议结果，缩小范围。
  3. 使用 --chain ethereum 或 --chain arbitrum 按链筛选，查看特定链的协议数据。
  4. 使用 --sort market_share 或 --sort tvl_to_mcap 按其他指标排序，找出被低估的协议。
  5. 运行 python onchain_analytics.py chains，获取所有受追踪网络的链级 TVL 排名。
  6. 运行 python onchain_analytics.py fees --protocol aave，获取特定协议的费用和收入数据。
  7. 运行 python onchain_analytics.py dex --chain ethereum，分析按链筛选的 DEX 交易量。
  8. 运行 python onchain_analytics.py yields --min-tvl 5000000 --chain ethereum，查找 TVL 高于最低阈值的收益机会。
  9. 运行 python onchain_analytics.py trends --threshold 5，检测 TVL 变化显著的协议（阈值以百分比表示）。
  10. 使用 --format json 或 --format csv 以 JSON 或 CSV 格式导出结果，并重定向到文件以供后续分析。

完整的四步实施工作流请参阅 ${CLAUDE_SKILL_DIR}/references/implementation.md。

输出

  • 协议排名表，包含名称、TVL、市场份额百分比和 TVL 与市值之比
  • 链 TVL 排名，显示各网络的锁仓总价值
  • 各协议的费用和收入报告，按日、周、月细分
  • DEX 交易量表，按链和 DEX 细分
  • 按最低 TVL 和链筛选的收益机会列表，包含 APY 和资金池详情
  • 趋势协议提醒，显示超过配置阈值的 TVL 百分比变化
  • 稳定币市值摘要
  • JSON（output.json）或 CSV（output.csv）导出文件，供程序使用

错误处理

错误原因解决方案
Request timeoutDeFiLlama API 响应缓慢或无法访问稍后重试；查看是否发生故障；如果有缓存数据，则使用缓存数据
Protocol not found: invalid-name协议 slug 与 DeFiLlama 数据库不匹配运行 python onchain_analytics.py protocols 查找准确的 slug；slug 区分大小写
No data returned for query筛选条件过严或数据不可用移除筛选条件后重试；确认类别或链是否存在；尝试更宽泛的时间范围
TVL data unavailable for some protocols新协议或数据收集存在缺口直接查看 DeFiLlama；数据通常会在协议上线后的 24 小时内出现
Data may be stale (last updated: X hours ago)本地缓存未刷新使用 rm ~/.onchain_analytics_cache.json 清除缓存；使用 --verbose 查看缓存状态
Showing top 50 of 1000+ protocols为便于阅读，输出已截断使用 --limit 增加数量，或使用 --format json 获取完整且未截断的数据
UnicodeEncodeError终端编码不匹配使用 --format json 安全输出，或设置 LANG=en_US.UTF-8

示例

每日 DeFi 概览
python onchain_analytics.py protocols --limit 20
python onchain_analytics.py chains
python onchain_analytics.py trends

生成 TVL 排名前 20 的协议、所有链的排名，以及任何超过默认阈值的热门协议的快照。

研究借贷协议
python onchain_analytics.py protocols --category lending --sort tvl_to_mcap
python onchain_analytics.py fees --protocol aave

按 TVL 与市值的比率对所有借贷协议进行排名（以识别可能被低估的协议），然后提取 Aave 的详细费用和收入数据。

查找 Ethereum 上 TVL 较高的收益机会
python onchain_analytics.py yields --min-tvl 10000000 --chain ethereum --limit 50  # 10000000 = 10M limit

返回 Ethereum 上最多 50 个 TVL 至少为 1,000 万美元的收益池，并按 APY 排序。使用 --format csv > yields.csv 导出，以便进行电子表格分析。

资源

  • DeFiLlama API 文档 —— TVL、费用、收益和 DEX 交易量的主要数据来源
  • DeFiLlama 状态页面 —— 查看 API 可用性和服务中断报告
  • CoinGecko API —— 补充的代币价格和市值数据
  • Dune Analytics —— 使用针对链上数据的自定义 SQL 查询进行深入分析
  • The Graph —— 用于通过 GraphQL 查询区块链数据的去中心化索引协议

评论

支持 Markdown