Skip to main content

​
什么是 Cube？

Cube 是一种分析型数据模型，映射到一个或多个 OLAP 数据库表。每个 Cube 定义：
  • Dimensions — 可查询字段，组织为嵌套层级（例如 Block.Time、Trade.Buy.Currency.MintAddress）
  • Selectors — 顶层的快捷筛选参数（例如 tokenAddress），用于简化常见筛选模式
  • Metrics — Record 类型上可用的聚合函数（count、sum 等）
  • Defaults — 自动应用的默认筛选与分页 limit
查询 Cube 时，activecube-rs 会将 GraphQL 查询编译为针对该 Cube 底层表的优化 SQL；表名遵循 {chain}_{table_name} 模式（例如 sol_dex_trades、eth_transfers）。

​
Cube 概览

25 个 Cube 分为三个 Chain Group。每个 Cube 属于某一数据仓库层级：
  • DWD（明细层）— 逐事件原始数据，粒度最高
  • DWM（聚合层）— 预计算汇总（例如按分钟）
  • DWS（汇总层）— 高度聚合的快照
  • DIM（维度层）— 参考 / 查找表

​
EVM + Solana 共享 Cube

以下 Cube 在 EVM 与 Solana Chain Group 中均可用。
表： {chain}_dex_trades 默认 limit： 25（最大 10,000） 默认 filter： IsSuspect = false（默认排除 bot/MEV 成交） Selectors： tokenAddress、walletAddress、poolAddress、dexProgram、date Metrics： count、sum、avg、min、max、uniq关键字段：
适用场景： 成交历史、钱包成交分析、DEX 成交量拆解、大额成交检测。
表： {chain}_dex_trades_enriched（UNION 子查询 — 每笔成交一侧一行） Selectors： tokenAddress、sideType、poolAddress、dexProgram、date Metrics： count、sum、avg、min、max、uniq关键字段：
适用场景： 按代币查询成交（买卖两侧）、代币成交量分析、单代币高效筛选。
表： {chain}_transfers Selectors： tokenAddress、senderAddress、receiverAddress、date Metrics： count、sum、avg、uniq关键字段：
适用场景： 钱包转账历史、巨鲸监控、交易所充提追踪。
表： {chain}_balance_updates Selectors： ownerAddress、tokenAddress、date Metrics： count、sum、avg、min、max、uniq关键字段：
适用场景： 余额变动追踪、仓位监控、吸筹/派发识别。
表： {chain}_dex_pool_events_enriched Selectors： poolAddress、tokenAddress、date Metrics： count、sum、avg、max关键字段：
适用场景： 流动性增减监控、池子 TVL 追踪、新池发现。
表： {chain}_token_supplies Selectors： tokenAddress关键字段：
适用场景： mint/burn 事件追踪、供应变动告警、市值历史。
表： {chain}_blocks Selectors： date Metrics： count、sum、avg、min、max关键字段：
适用场景： 出块监控、gas 分析（EVM）、slot 追踪（Solana）。
表： {chain}_transactions Selectors： date、txHash/txSignature、fromAddress、toAddress、feePayer、signer Metrics： count、sum、avg、min、max关键字段：
适用场景： 交易查询、gas/fee 分析、活跃度监控。
表： {chain}_transaction_balances Selectors： date、address、currency Metrics： count、sum、avg、min、max关键字段：
适用场景： 单笔交易对余额的影响分析、代币流向追踪。
该 Cube 不支持 dataset 切换（无 _realtime / _archive 等表变体）。

​
Solana 专属 Cube

以下 Cube 仅在 Solana Chain Group 中可用。
表： sol_instructions_enriched Selectors： date、programId、txSignature Metrics： count、uniq关键字段：
适用场景： 程序交互分析、instruction 级调试、协议使用追踪。
表： sol_balance_updates_enriched Selectors： date、tokenAddress、ownerAddress、programId Metrics： count、sum、avg、min、max、uniq关键字段：
适用场景： instruction 级余额影响分析、程序手续费追踪。
该 Cube 不支持 dataset 切换。
表： sol_rewards Selectors： date、address Metrics： count、sum、avg关键字段：
适用场景： staking 奖励追踪、验证者表现、奖励历史。
表： sol_dex_orders Selectors： date、marketAddress、orderType、ownerAddress Metrics： count、sum、avg、uniq关键字段：
适用场景： 订单簿分析、限价单追踪、市场微观结构研究。

​
EVM 专属 Cube

以下 Cube 仅在 EVM Chain Group（eth、bsc、polygon）中可用。
表： {chain}_logs_enriched Selectors： date、contractAddress、txHash、topic0 Metrics： count、uniq关键字段：
适用场景： 智能合约 event 监控、协议活动追踪、自定义 event 筛选。
表： {chain}_traces_enriched Selectors： date、txHash、toAddress Metrics： count、sum、uniq关键字段：
适用场景： 内部交易 trace、合约交互分析、MEV 检测。
表： {chain}_miner_rewards Selectors： date、miner Metrics： count、sum、avg、min、max关键字段：
适用场景： 验证者/矿工奖励分析、区块奖励趋势、MEV 收入追踪。
表： {chain}_dex_pool_slippages Selectors： date、poolAddress Metrics： count、avg、min、max关键字段：
适用场景： 滑点监控、池子深度分析、执行质量评估。
表： {chain}_uncles Selectors： date、miner Metrics： count关键字段：
适用场景： Uncle 区块分析、网络健康监控（主要为 Ethereum PoW 历史数据）。

​
Trading Cube（跨链）

以下 Cube 属于 Trading Chain Group，在全部支持的链（sol、eth、bsc）上汇总数据，并包含用于筛选的 chain dimension。
表： 跨链物化视图（{chain}_ohlc_mv） Selectors： tokenAddress、chain、date Metrics： count、sum、avg、min、max关键字段：
适用场景： K 线图、价格历史、成交量分析、跨链价格对比。
表： 跨链物化视图（{chain}_token_trade_stats_mv） Selectors： tokenAddress、chain、date Metrics： count、sum、avg、min、max关键字段：
适用场景： 买卖压力分析、独立交易者数量、成交量趋势、跨链代币对比。

​
汇总 Cube（DWS）

汇总 Cube 提供高度聚合、快照式数据，便于快速查询。
表： {chain}_dex_pools（DWS 层） Selectors： poolAddress、tokenA、tokenB Metrics： count关键字段：
适用场景： 池子发现、当前流动性排名、池子元数据查询。
该 Cube 不支持 dataset 切换或基于时间的筛选；表示池子状态的最新快照。
表： {chain}_token_holders Selectors： tokenAddress关键字段：
适用场景： 大户列表、持有者分布、巨鲸追踪。
该 Cube 不支持 dataset 切换。
表： {chain}_wallet_token_pnl Selectors： walletAddress关键字段：
适用场景： 按代币的钱包 PnL、交易表现排行榜、组合分析。
该 Cube 不支持 dataset 切换。

​
预测市场 Cube

以下 Cube 在 EVM Chain Group 中可用，主要用于 Polygon 上的预测市场协议。
表： {chain}_prediction_trades Selectors： date、conditionId、questionId、marketplace Metrics： count、sum、avg、min、max、uniq关键字段：
适用场景： 预测市场成交历史、结果定价、marketplace 成交量。
预测市场 Cube 不支持 dataset 切换。
表： {chain}_prediction_managements Selectors： date、eventType、conditionId、questionId Metrics： count、sum、avg、min、max、uniq关键字段：
适用场景： 市场创建/结算追踪、condition 管理事件。
表： {chain}_prediction_settlements Selectors： date、eventType、conditionId、holder Metrics： count、sum、avg、min、max、uniq关键字段：
适用场景： 结算追踪、派息分析、头寸赎回监控。

​
选择合适的 Cube

在满足需求的前提下，优先选择聚合度最高的 Cube。对时间序列与摘要类数据，DWM/DWS Cube 通常比 DWD Cube 快几个数量级。

​
Dataset 兼容性

并非所有 Cube 都支持 dataset 参数（realtime/archive/combined）。以下 Cube 无论 dataset 取何值，都会查询全表：
  • TokenHolders、WalletTokenPnL、DEXPools（DWS 层 — 始终为最新快照）
  • TransactionBalances
  • PredictionTrades、PredictionManagements、PredictionSettlements
详见 Dataset 与 Aggregates。

​
下一步

Chain Groups

了解 EVM、Solana 与 Trading Chain Group。

筛选

使用 where 与 selector 快捷方式筛选。

指标与聚合

使用 count、sum、avg、min、max、uniq 聚合数据。