核心用法
Dune Analytics API 技能为区块链数据分析提供完整工具链,主要功能包括:
1. 查询执行与管理:支持执行保存的查询(run_query,含参数化查询)、直接执行 SQL(run_sql,Plus 计划)、获取缓存结果(get_latest_result)以及查询创建与更新
2. 数据上传功能:CSV/NDJSON 快速上传(覆盖模式)、创建自定义表结构、支持追加模式的数据插入,适用于整合链下数据
3. SQL 优化指导:内置 CTE 优化、JOIN 策略、数组操作、分区裁剪等最佳实践,特别针对 Solana 和 EVM 链的数据特性
4. 关键数据表解析:
dex.tradesvsdex_aggregator.trades:前者用于池级分析(交易量虚高约 30%),后者用于用户/钱包分析- Solana 特殊处理:无 aggregator 表,需通过
tx_id去重 - 数据时效性分层:原始数据(<1 分钟)、解码数据(15-60 秒)、精选数据(约 1 小时+)
显著优点
- 多链覆盖:完整支持 Ethereum、Solana 等主流公链的原始、解码、精选三层数据
- 成本透明:内置 credits 消耗追踪机制,帮助用户控制查询成本
- 灵活数据整合:支持链下数据上传与链上数据关联分析
- 专业 SQL 指导:针对区块链数据特性的优化建议,降低查询成本
潜在缺点与局限性
- 计划限制:
run_sql直接执行需 Plus 付费计划,免费用户仅限执行已保存查询 - 数据延迟:精选表(如 dex.trades)存在约 1 小时延迟,实时分析需使用原始/解码表
- Solana 不完善:缺乏 aggregator 专用表,需手动去重处理
- API Key 依赖:所有功能强制依赖 DUNE_API_KEY,无备用数据源
适合人群
- DeFi 分析师、链上研究员、投资组合经理
- 需要整合链下数据(如用户标签、价格数据)的量化团队
- 开发链上监控、预警系统的工程团队
- 学术研究者进行区块链经济活动分析
常规风险
1. 成本失控风险:复杂查询或大范围数据扫描可能快速消耗 credits,建议始终关注执行后的 credits 报告
2. 数据误读风险:混淆 dex.trades 与 dex_aggregator.trades 会导致交易量误判;Solana 数据未去重会造成重复计算
3. 隐私数据泄露:上传 CSV 时默认 is_private=True 为安全做法,但公共查询可能被他人查看
4. 时效性误判:UTC 12:00 前查询当日数据可能不完整,关键决策需确认数据层延迟