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 聚合資料。