Dune Analytics API

核心功能

Dune Analytics API 是一个面向区块链数据分析的专业级技能，支持通过Python SDK与Dune平台深度交互。其核心能力涵盖七大场景：表结构发现与Schema检查、查询执行与刷新、SQL性能优化（针对Solana/EVM链）、DEX交易数据解析（dex.trades与dex_aggregator.trades的差异化应用）、Solana交易与日志解析、查询参数与结果管理，以及CSV/NDJSON数据上传至Dune自建表。

显著优势

1. 数据权威性：直接对接Dune Analytics——业界领先的链上数据分析平台，拥有最全面的EVM与Solana解码数据
2. 工作流标准化：内置严格的「先读参考文档再写SQL」规则，避免常见反模式（如误用dex.trades做钱包分析）
3. 多层级数据覆盖：从原始区块数据（<1分钟延迟）到策展数据（dex.trades等），满足不同时效性需求
4. 灵活的数据上传：支持快速CSV上传覆盖或分schema建表+增量插入两种模式

局限性与风险

• 订阅门槛：run_sql即时执行需Plus付费计划，免费用户仅支持run_query调用已保存查询
• Credits消耗：每次查询消耗平台积分，高频调用需成本规划
• Solana特殊性：无dex_aggregator_solana.trades表，需手动按tx_id去重
• 数据延迟：策展表约1小时+延迟，当日数据分析需等待UTC 12:00后

适用人群

DeFi研究员、Crypto投研分析师、量化策略开发者、链上数据科学家、Web3产品经理。

安全提示

API Key需妥善保管，建议通过环境变量配置；数据上传功能涉及用户命名空间权限，需确认写入范围避免误覆盖。

核心用法

该技能通过与 Dune Analytics 官方 API 集成，提供全面的区块链数据查询与分析能力。主要功能包括：

1. 数据查询与执行

• 执行已保存的查询（支持参数化查询 {{param}}）
• 直接执行原始 SQL（Plus 订阅计划）
• 获取缓存结果避免重复执行消耗 credits
• 支持查询更新与版本管理

2. 表发现与 Schema 检查

• 按名称搜索数据表
• 检查表结构与列定义
• 浏览不同 schema 和上传的数据
• 优先使用 table-discovery.md 参考文档

3. 专用场景支持

• DEX 交易分析：区分 dex.trades（池级分析）与 dex_aggregator.trades（钱包级分析），避免 30% 的重复计算偏差
• Solana 链支持：处理 Solana 交易解析，使用 tx_id 去重处理聚合器交易
• 钱包追踪：EVM 与 Solana 多链地址监控、手续费分析、路由地址识别

4. 数据上传

• CSV/NDJSON 格式数据上传至 Dune 平台
• 创建私有数据表并插入数据
• 支持数据追加与覆盖模式

5. SQL 优化

• CTE 使用策略、JOIN 优化技巧
• 数组操作与分区裁剪
• 针对 Solana/EVM 链的性能调优建议

显著优点

• 权威性保障：直接对接 Dune Analytics 官方 API，数据来源可靠，涵盖以太坊、Solana 等主流公链的原始、解码和精选数据层
• 专业深度：内置区块链领域专业知识，如 dex.trades 与 dex_aggregator.trades 的精确区分、Solana 特殊去重逻辑等
• 成本透明：严格执行 credits 追踪，支持缓存策略降低查询成本
• 安全合规：支持私有表创建（is_private=True），数据上传遵循隐私最佳实践
• 文档完善：7 个参考文档覆盖表发现、查询执行、SQL 优化、钱包分析、数据上传等全场景

潜在缺点与局限性

• 订阅限制：run_sql 直接执行 SQL 功能需要 Plus 订阅，免费计划仅支持参数化查询
• 数据延迟：精选数据（如 dex.trades）有约 1 小时延迟，实时分析需使用原始/解码层数据
• API 依赖：完全依赖 Dune Analytics 服务可用性，存在单点故障风险
• Solana 功能缺口：无原生 dex_aggregator_solana.trades 表，需手动 tx_id 去重
• Credits 消耗：复杂查询可能快速消耗 API credits，需要成本意识

适合的目标群体

• Web3 分析师：需要快速获取链上数据进行市场分析、项目评估
• DeFi 研究员：DEX 交易量、流动性、用户行为等深度分析
• 加密货币基金经理：投资组合监控、地址追踪、资金流向分析
• 数据工程师：需要将链下数据与链上数据融合分析
• 开发者：构建链上数据驱动的应用，需要程序化查询能力

使用风险

性能风险：

• 复杂 JOIN 和大表扫描可能导致查询超时或高额 credits 消耗
• 建议遵循 sql-optimization.md 中的最佳实践

依赖项风险：

• 依赖 dune-client 官方包，需保持版本更新
• 网络连接中断会导致 API 调用失败

凭证安全风险：

• DUNE_API_KEY 泄露可能导致账户 credits 被恶意消耗
• 建议在安全环境（如密码管理器）中存储，避免硬编码

数据隐私风险：

• 上传至公共表的数据可被其他用户访问
• 敏感业务数据务必使用 is_private=True

数据准确性风险：

• dex.trades 多跳交易重复计算约 30% 偏差
• Solana 需手动去重，误用可能导致分析错误