Skip to main content

​
Cubeとは

Cubeは、1つ以上のOLAPデータベーステーブルにマッピングされる分析データモデルです。各Cubeは以下を定義します：
  • ディメンション — ネストされた階層で整理されたクエリ可能なフィールド（例：Block.Time、Trade.Buy.Currency.MintAddress）
  • セレクター — トップレベルのショートカットフィルタ引数（例：tokenAddress）で、一般的なフィルタパターンを簡素化
  • メトリクス — Recordタイプで利用可能な集計関数（count、sumなど）
  • デフォルト — 自動的に適用されるデフォルトフィルタとページネーション制限
Cubeにクエリを実行すると、activecube-rsはGraphQLクエリをCubeのバッキングテーブルに対する最適化されたSQLにコンパイルします。テーブルは{chain}_{table_name}（例：sol_dex_trades、eth_transfers）の命名パターンに従います。

​
Cube一覧

25のCubeが3つのチェーングループに整理されています。各Cubeはデータウェアハウスレイヤーに属します：
  • DWD（Detail） — イベント単位の生データ、最高粒度
  • DWM（Aggregated） — 事前計算されたロールアップ（例：分単位）
  • DWS（Summary） — 高度に集計されたスナップショット
  • DIM（Dimension） — 参照/ルックアップテーブル

​
EVM + Solana共有Cube

これらのCubeはEVMとSolanaの両方のチェーングループで利用可能です。
テーブル: {chain}_dex_trades デフォルトリミット: 25（最大10,000） デフォルトフィルタ: IsSuspect = false（ボット/MEVトレードはデフォルトで除外） セレクター: tokenAddress、walletAddress、poolAddress、dexProgram、date メトリクス: count、sum、avg、min、max、uniq主要フィールド：
ユースケース: トレード履歴、ウォレットトレード分析、DEX出来高内訳、大口トレード検出。
テーブル: {chain}_dex_trades_enriched（UNIONサブクエリ — トレード側ごとに1行） セレクター: tokenAddress、sideType、poolAddress、dexProgram、date メトリクス: count、sum、avg、min、max、uniq主要フィールド：
ユースケース: トークン単位のトレードクエリ（買い・売り両方）、トークン出来高分析、効率的な単一トークンフィルタリング。
テーブル: {chain}_transfers セレクター: tokenAddress、senderAddress、receiverAddress、date メトリクス: count、sum、avg、uniq主要フィールド：
ユースケース: ウォレットトランスファー履歴、クジラモニタリング、取引所入出金追跡。
テーブル: {chain}_balance_updates セレクター: ownerAddress、tokenAddress、date メトリクス: count、sum、avg、min、max、uniq主要フィールド：
ユースケース: 残高変更追跡、ポジションモニタリング、蓄積/分配検出。
テーブル: {chain}_dex_pool_events_enriched セレクター: poolAddress、tokenAddress、date メトリクス: count、sum、avg、max主要フィールド：
ユースケース: 流動性追加/削除モニタリング、プールTVL追跡、新規プール検出。
テーブル: {chain}_token_supplies セレクター: tokenAddress主要フィールド：
ユースケース: ミント/バーンイベント追跡、サプライ変更アラート、時価総額履歴。
テーブル: {chain}_blocks セレクター: date メトリクス: count、sum、avg、min、max主要フィールド：
ユースケース: ブロック生成モニタリング、ガス分析（EVM）、スロット追跡（Solana）。
テーブル: {chain}_transactions セレクター: date、txHash/txSignature、fromAddress、toAddress、feePayer、signer メトリクス: count、sum、avg、min、max主要フィールド：
ユースケース: トランザクション検索、ガス/手数料分析、アクティビティモニタリング。
テーブル: {chain}_transaction_balances セレクター: date、address、currency メトリクス: count、sum、avg、min、max主要フィールド：
ユースケース: トランザクション単位の残高影響分析、トークンフロー追跡。
このCubeはdataset切り替えをサポートしていません（_realtime / _archiveテーブルバリアントなし）。

​
Solana専用Cube

これらのCubeはSolanaチェーングループでのみ利用可能です。
テーブル: sol_instructions_enriched セレクター: date、programId、txSignature メトリクス: count、uniq主要フィールド：
ユースケース: プログラムインタラクション分析、インストラクションレベルのデバッグ、プロトコル使用量追跡。
テーブル: sol_balance_updates_enriched セレクター: date、tokenAddress、ownerAddress、programId メトリクス: count、sum、avg、min、max、uniq主要フィールド：
ユースケース: インストラクションレベルの残高影響分析、プログラム手数料追跡。
このCubeはdataset切り替えをサポートしていません。
テーブル: sol_rewards セレクター: date、address メトリクス: count、sum、avg主要フィールド：
ユースケース: ステーキングリワード追跡、バリデータパフォーマンス、リワード履歴。
テーブル: sol_dex_orders セレクター: date、marketAddress、orderType、ownerAddress メトリクス: count、sum、avg、uniq主要フィールド：
ユースケース: オーダーブック分析、リミットオーダー追跡、市場マイクロ構造研究。

​
EVM専用Cube

これらのCubeはEVMチェーングループ（eth、bsc、polygon）でのみ利用可能です。
テーブル: {chain}_logs_enriched セレクター: date、contractAddress、txHash、topic0 メトリクス: count、uniq主要フィールド：
ユースケース: スマートコントラクトイベントモニタリング、プロトコルアクティビティ追跡、カスタムイベントフィルタリング。
テーブル: {chain}_traces_enriched セレクター: date、txHash、toAddress メトリクス: count、sum、uniq主要フィールド：
ユースケース: 内部トランザクショントレース、コントラクトインタラクション分析、MEV検出。
テーブル: {chain}_miner_rewards セレクター: date、miner メトリクス: count、sum、avg、min、max主要フィールド：
ユースケース: バリデータ/マイナーリワード分析、ブロックリワードトレンド、MEV収益追跡。
テーブル: {chain}_dex_pool_slippages セレクター: date、poolAddress メトリクス: count、avg、min、max主要フィールド：
ユースケース: スリッページモニタリング、プール深度分析、約定品質評価。
テーブル: {chain}_uncles セレクター: date、miner メトリクス: count主要フィールド：
ユースケース: アンクルブロック分析、ネットワーク健全性モニタリング（主にEthereum PoWの履歴データ）。

​
Trading Cube（クロスチェーン）

これらのCubeはTradingチェーングループにあります。すべての対応チェーン（sol、eth、bsc）からのデータを集計し、フィルタリング用のchainディメンションを含みます。
テーブル: チェーン間のマテリアライズドビュー（{chain}_ohlc_mv） セレクター: tokenAddress、chain、date メトリクス: count、sum、avg、min、max主要フィールド：
ユースケース: ローソク足チャート、価格履歴、出来高分析、クロスチェーン価格比較。
テーブル: チェーン間のマテリアライズドビュー（{chain}_token_trade_stats_mv） セレクター: tokenAddress、chain、date メトリクス: count、sum、avg、min、max主要フィールド：
ユースケース: 売買圧力分析、ユニークトレーダー数、出来高トレンド、クロスチェーントークン比較。

​
サマリーCube（DWS）

サマリーCubeは高度に集計されたスナップショット形式のデータを提供し、素早い検索に最適です。
テーブル: {chain}_dex_pools（DWSレイヤー） セレクター: poolAddress、tokenA、tokenB メトリクス: count主要フィールド：
ユースケース: プール発見、現在の流動性ランキング、プールメタデータ検索。
このCubeはdataset切り替えや時間ベースのフィルタリングをサポートしていません。プール状態の最新スナップショットを表します。
テーブル: {chain}_token_holders セレクター: tokenAddress主要フィールド：
ユースケース: トップホルダーリスト、ホルダー分布、クジラ追跡。
このCubeはdataset切り替えをサポートしていません。
テーブル: {chain}_wallet_token_pnl セレクター: walletAddress主要フィールド：
ユースケース: トークン単位のウォレットPnL、トレーディングパフォーマンスリーダーボード、ポートフォリオ分析。
このCubeはdataset切り替えをサポートしていません。

​
予測市場Cube

これらのCubeはEVMチェーングループで利用可能で、主にPolygonの予測市場プロトコルで使用されます。
テーブル: {chain}_prediction_trades セレクター: date、conditionId、questionId、marketplace メトリクス: count、sum、avg、min、max、uniq主要フィールド：
ユースケース: 予測市場トレード履歴、結果価格設定、マーケットプレイス出来高。
予測市場Cubeはdataset切り替えをサポートしていません。
テーブル: {chain}_prediction_managements セレクター: date、eventType、conditionId、questionId メトリクス: count、sum、avg、min、max、uniq主要フィールド：
ユースケース: マーケット作成/解決追跡、条件管理イベント。
テーブル: {chain}_prediction_settlements セレクター: date、eventType、conditionId、holder メトリクス: 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
詳細はデータセットとアグリゲートをご覧ください。

​
次のステップ

チェーングループ

EVM、Solana、Tradingチェーングループを理解。

フィルタリング

whereとセレクターショートカットでフィルタリングを学習。

メトリクスと集計

count、sum、avg、min、max、uniqでデータを集計。