Skip to main content

Cube란?

Cube는 하나 이상의 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는 세 개의 체인 그룹으로 구성됩니다. 각 Cube는 데이터 웨어하우스 레이어에 속합니다:
  • DWD (Detail) — 이벤트별 원시 데이터, 최고 세분화
  • DWM (Aggregated) — 사전 계산된 롤업 (예: 분별)
  • DWS (Summary) — 고도로 집계된 스냅샷
  • DIM (Dimension) — 참조/조회 테이블

EVM + Solana 공유 Cube

이 Cube들은 EVMSolana 체인 그룹 모두에서 사용할 수 있습니다.
테이블: {chain}_dex_trades 기본 limit: 25 (최대 10,000) 기본 필터: IsSuspect = false (봇/MEV 트레이드 기본 제외) 셀렉터: tokenAddress, walletAddress, poolAddress, dexProgram, date 메트릭: count, sum, avg, min, max, uniq주요 필드:
사용 사례: 트레이드 히스토리, 월렛 트레이드 분석, DEX 거래량 분류, 대규모 트레이드 탐지.
테이블: {chain}_dex_trades_enriched (UNION 서브쿼리 — 트레이드 측면당 한 행) 셀렉터: 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주요 필드:
사용 사례: 매수/매도 압력 분석, 고유 트레이더 수, 거래량 추세, 크로스체인 토큰 비교.

Summary Cube (DWS)

Summary 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로 데이터를 집계하세요.