ChainStream GraphQL은 25개의 Cube를 세 가지 Chain Group 으로 묶습니다. 각 그룹은 블록체인 생태계를 나타내며, 어떤 Cube를 쓸 수 있는지, network 파라미터가 어떻게 동작하는지, 체인별 필드가 무엇인지를 결정합니다.
type ChainStream { EVM ( network : Network ! , dataset : Dataset , aggregates : Aggregates ) { ... } Solana ( network : SolanaNetwork , dataset : Dataset , aggregates : Aggregates ) { ... } Trading ( dataset : Dataset , aggregates : Aggregates ) { ... } }
EVM EVM 그룹에는 모든 EVM 호환 블록체인용 Cube가 포함됩니다. 조회할 체인을 지정하려면 network 인자가 필수사용 가능한 네트워크 네트워크 ID 블록체인 ethEthereum bscBNB Chain (BSC) polygonPolygon
Polygon 데이터 가용성: 현재 Polygon에서 데이터가 있는 Cube는 예측 시장(Prediction Markets) Cube(PredictionTrades, PredictionManagements, PredictionSettlements)뿐입니다. 다른 Cube(DEXTrades, Blocks, Transfers 등)는 배포 중이며, 해당 Cube에 대한 쿼리는 오류를 반환할 수 있습니다.
Cube Solana와 공유:
DEXTrades, DEXTradeByTokens, Transfers, BalanceUpdates, DEXPoolEvents, TokenSupplyUpdates, Blocks, Transactions, TransactionBalances, DEXPools, TokenHolders, WalletTokenPnLEVM 전용:
Events — 스마트 컨트랙트 이벤트 로그(디코딩된 topic·data)Calls — 내부 호출 트레이스(CALL, DELEGATECALL, CREATE 등)MinerRewards — 블록 보상 분해(static, dynamic, uncle, burned fees)DEXPoolSlippages — 풀 가격 슬리피지 분석Uncles — Uncle 블록 데이터(주로 Ethereum PoW 과거)PredictionTrades — 예측 시장 거래 (주로 Polygon) PredictionManagements — 예측 시장 관리 이벤트 (주로 Polygon) PredictionSettlements — 예측 시장 정산 (주로 Polygon)
예시 쿼리 query { EVM ( network : eth , dataset : combined ) { DEXTrades ( limit : { count : 10 } orderBy : { descending : Block_Time } ) { Block { Time Number } Transaction { Hash } Trade { Buy { Currency { SmartContract Symbol } Amount PriceInUSD } Sell { Currency { SmartContract Symbol } Amount } Dex { ProtocolName } } } } }
Solana Solana 그룹에는 Solana 블록체인용 Cube가 들어 있습니다. network 인자를 사용할 수 있으며 값은 solana입니다. 선택 사항이며 기본값은 solana입니다.Cube EVM과 공유:
DEXTrades, DEXTradeByTokens, Transfers, BalanceUpdates, DEXPoolEvents, TokenSupplyUpdates, Blocks, Transactions, TransactionBalances, DEXPools, TokenHolders, WalletTokenPnLSolana 전용:
Instructions — 프로그램 instruction 데이터(프로그램 주소, 메서드, 계정, 로그)InstructionBalanceUpdates — instruction 단위 잔액 변화Rewards — 검증자·스테이킹 보상DEXOrders — DEX 오더북 이벤트(지정가 주문, 취소, 체결)
예시 쿼리 query { Solana ( dataset : realtime ) { DEXTrades ( limit : { count : 10 } orderBy : { descending : Block_Time } ) { Block { Time Slot } Transaction { Hash } Trade { Buy { Currency { MintAddress Symbol } Amount PriceInUSD } Sell { Currency { MintAddress Symbol } Amount } Dex { ProgramAddress ProtocolName } } } } }
체인 간 필드 이름 아래 표는 체인별 관례적인 필드 이름입니다. 다만 Record 타입에는 모든 체인의 필드를 합친 superset 이 들어 있어, 모든 Cube의 Record에 MintAddress와 SmartContract가 함께 존재하며 동일한 기본 데이터를 가리킵니다. 어떤 체인에서든 둘 중 하나를 쓸 수 있습니다.
개념 관례(Solana) 관례(EVM) 크로스체인? 토큰 주소 MintAddressSmartContract모든 체인에서 둘 다 동작 트랜잭션 ID Signature / HashHash모든 체인에서 둘 다 동작 블록 식별자 SlotNumber모든 체인에서 둘 다 동작 프로그램/컨트랙트 ProgramAddressSmartContract모든 체인에서 둘 다 동작 수수료 지불자 FeePayerFrom모든 체인에서 둘 다 동작
즉 하나의 쿼리 템플릿 으로 모든 체인을 다룰 때 필드 이름을 바꿀 필요가 없습니다. 예를 들어 Solana·EVM 쿼리 모두에서 Currency { MintAddress }가 동작합니다.
Trading Trading 그룹은 크로스체인 사전 집계 거래 분석을 제공합니다. 지원 체인 데이터를 통합한 materialized view에 chain 차원으로 필터링할 수 있습니다.Cube
Pairs — OHLC 캔들(open/high/low/close, 거래량, 거래 건수)Tokens — 토큰별 거래 통계(거래량, 매수/매도 분해, 고유 트레이더 수)
EVM/Solana 그룹과의 주요 차이
network 인자 없음chain 차원을 사용하세요.크로스체인 데이터 — 한 쿼리로 sol, eth, bsc 등을 함께 반환할 수 있습니다.사전 집계 — DWM 레이어에서 분 단위로 materialize된 데이터입니다.
예시: 크로스체인 OHLC query { Trading ( aggregates : yes ) { Pairs ( where : { Token : { Address : { is : "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" } } } limit : { count : 60 } orderBy : { descending : Block_Time } ) { Token { Address } Market { Network } Interval { Time } Price { Ohlc { Open High Low Close } } Volume { Usd Native } Stats { TradeCount BuyCount SellCount } } } }
예시: 체인별 토큰 거래 통계 query { Trading { Tokens ( where : { Token : { Address : { is : "0xdac17f958d2ee523a2206206994597c13d831ec7" } } Market : { Network : { is : "eth" } } } limit : { count : 30 } orderBy : { descending : Block_Time } ) { Interval { Time } Volume { Usd BuyVolumeUSD SellVolumeUSD } Stats { TradeCount UniqueBuyers UniqueSellers } } } }
Chain Group 비교 기능 EVM Solana Trading network 인자필수(eth, bsc, polygon) 선택(solana, 기본값 solana) 불필요(크로스체인) 고유 Cube Events, Calls, MinerRewards, Uncles, DEXPoolSlippages, Prediction* Instructions, InstructionBalanceUpdates, Rewards, DEXOrders Pairs, Tokens 데이터 세분도 이벤트 단위(DWD) + 집계(DWM/DWS) 이벤트 + instruction 단위 사전 집계(DWM) dataset 지원예(대부분 Cube) 예(대부분 Cube) 예 aggregates 지원예 예 예
관련 문서
데이터 Cube 25개 Cube 전체의 필드 구조와 사용 사례.
Dataset과 Aggregates 데이터 소스 범위와 사전 집계 동작 제어.
