Dune 可视化教程使用指南

本文面向 2025 年及以后使用 Dune Analytics 进行链上数据可视化的用户，在遵循 E‑E‑A‑T（专业性、经验、权威、可信度）原则的前提下，系统阐述从环境初始化到常见任务操作、错误排查以及风险提示的完整流程。文中引用的权威机构包括链研院（2024 年报告）与区块链数据联盟（2023 年白皮书）等。

目录

• 1️⃣ 初始化与常用设置
• 2️⃣ 典型任务分步
  • 2.1 充值（Deposit）
  • 2.2 提现（Withdraw）
  • 2.3 C2C（点对点交易）
  • 2.4 现货（Spot Trading）
  • 2.5 合约（Derivatives / Futures）
• 3️⃣ 常见错误与排查
• 4️⃣ FAQ 与风险提示
  • 4.1 常见问答
  • 4.2 风险提示
• 5️⃣ 小结

1️⃣ 初始化与常用设置

2️⃣ 典型任务分步

下面以 充值 / 提现 / C2C / 现货 / 合约 五大业务场景为例，展示从数据提取到可视化的完整流程。所有示例均采用 SQL‑like 语法（Dune 自研的 DuneSQL），并配合 Chart.js 生成交互式图表。

2.1 充值（Deposit）

1. 查询充值记录

   SELECT    block_timestamp AS time,    tx_hash,    from_address AS user,    value / 1e18 AS amount_ethFROM ethereum.transactionsWHERE to_address = '{{exchange_contract}}'  AND value > 0  AND block_timestamp >= CURRENT_DATE - INTERVAL '30' DAYORDER BY time DESC

2. 可视化：在「Visualization」选项卡选择 Line Chart，X 轴设为 time，Y 轴设为 amount_eth，并勾选「累计」以展示每日累计充值量。

3. 保存仪表盘：点击「Add to Dashboard」→「Deposit Overview」。

2.2 提现（Withdraw）

1. 查询提现事件（合约中 Withdraw 事件）

   SELECT    evt_block_time AS time,    evt_tx_hash AS tx_hash,    evt_args.user AS user,    evt_args.amount / 1e18 AS amount_ethFROM ethereum.event_logsWHERE contract_address = '{{exchange_contract}}'  AND evt_name = 'Withdraw'  AND evt_block_time >= CURRENT_DATE - INTERVAL '30' DAY

2. 可视化：使用 Bar Chart，X 轴为 time（按日分组），Y 轴为 SUM(amount_eth)，并在图表右上角添加「成功率」指标（成功提现 / 总提现请求）。

3. 报警：在「Alerts」中设置阈值，如日提现量突降 30% 以上触发邮件提醒。

2.3 C2C（点对点交易）

1. 提取匹配订单

   SELECT    block_timestamp AS time,    tx_hash,    from_address AS seller,    to_address AS buyer,    value / 1e18 AS amount_eth,    evt_args.price / 1e8 AS price_usdFROM ethereum.event_logsWHERE contract_address = '{{c2c_marketplace}}'  AND evt_name = 'MatchOrder'

2. 可视化：采用 Scatter Plot，X 轴为 price_usd，Y 轴为 amount_eth，点的大小映射 value，实现价格‑成交量关系的直观展示。

3. 交叉分析：在同一仪表盘加入「买卖双方活跃度」的 Pie Chart，分别统计 seller 与 buyer 的出现次数。

2.4 现货（Spot Trading）

1. 查询交易对成交

   SELECT    block_timestamp AS time,    evt_args.pair AS pair,    evt_args.amount / 1e18 AS amount,    evt_args.price / 1e8 AS priceFROM ethereum.event_logsWHERE contract_address = '{{spot_exchange}}'  AND evt_name = 'Trade'

2. 可视化：为每个 pair 创建 Area Chart（成交量随时间的变化），并在「Dashboard」中使用「Tabs」切换不同交易对。

3. 深度图：利用 Plotly 插件绘制 Order Book Depth，实时展示买卖挂单的累计深度。

2.5 合约（Derivatives / Futures）

1. 提取合约持仓变化

   SELECT    block_timestamp AS time,    evt_args.account AS trader,    evt_args.position / 1e8 AS position,    evt_args.pnl / 1e8 AS pnlFROM ethereum.event_logsWHERE contract_address = '{{futures_contract}}'  AND evt_name IN ('PositionOpened', 'PositionClosed')

2. 可视化：使用 Line Chart 双轴显示 position（左轴）与 pnl（右轴），帮助运营团队监控整体杠杆风险。

3. 风险阈值：在「Alerts」中设定 position 超过 10,000 合约单位时自动发送 Slack 通知。

3️⃣ 常见错误与排查

排查技巧：在 Dune 控制台左侧的「Logs」窗口可以实时查看错误堆栈；若仍无法定位，可参考 链研院（2024） 发布的《Dune 使用最佳实践》章节 4.2。

4️⃣ FAQ 与风险提示

4.1 常见问答

4.2 风险提示

1. 数据时效性风险：Dune 的块同步延迟可能导致 5–10 分钟 的滞后，业务决策应考虑此窗口。
2. 配额费用风险：免费额度用尽后若未及时升级套餐，自动降级会导致查询失败，影响报表的连续性。
3. 合约升级风险：若链上合约进行 ABI 或 事件名称 调整，原有查询将失效，需要及时更新 evt_name 与 contract_address。
4. 合规监管风险：在某些司法辖区，链上数据的使用需遵守 GDPR、中国网络安全法 等规定，建议在使用前咨询合规部门。
5. 安全风险：开启 API 密钥后，请妥善保管，不要在公开仓库或前端代码中泄露；若发现泄露，请立即在「API」页面撤销并重新生成。

温馨提醒：所有可视化结果仅供参考，切勿将其用于 短期价格预测 或 投资决策，以免触犯当地金融监管。

5️⃣ 小结

通过本文的 初始化 → 任务实现 → 错误排查 → FAQ/风险 全链路指引，您可以在 2025 年的链上生态中，快速搭建 Dune 可视化仪表盘，实现充值、提现、C2C、现货、合约等业务的实时监控与数据洞察。坚持 E‑E‑A‑T 原则、遵循权威机构的最佳

延伸阅读

• Binance Authenticator 使用指南
• Bitfinex借贷功能使用指南
• Binance App使用指南