ChainStream GraphQL 將其 25 個 Cube 劃分為三個 鏈組（Chain Groups）。每個組代表一類區塊鏈生態，決定可用的 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 | 區塊鏈 |
|---|
eth | Ethereum |
bsc | BNB Chain (BSC) |
polygon | Polygon |
Polygon 資料可用性： 目前僅有 預測市場 相關 Cube（PredictionTrades、PredictionManagements、PredictionSettlements）在 Polygon 上有資料。其他 Cube（DEXTrades、Blocks、Transfers 等）正在部署中 —— 對它們的查詢可能返回錯誤。
Cubes
與 Solana 共用：
DEXTrades、DEXTradeByTokens、Transfers、BalanceUpdates、DEXPoolEvents、TokenSupplyUpdates、Blocks、Transactions、TransactionBalances、DEXPools、TokenHolders、WalletTokenPnL
僅 EVM：
Events — 智慧合約事件日誌（已解碼的 topic 與 data）Calls — 內部呼叫追蹤（CALL、DELEGATECALL、CREATE 等）MinerRewards — 出塊獎勵明細（靜態、動態、叔塊、銷燬手續費等）DEXPoolSlippages — 池子價格滑點分析Uncles — 叔塊資料（主要為以太坊 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。
Cubes
與 EVM 共用：
DEXTrades、DEXTradeByTokens、Transfers、BalanceUpdates、DEXPoolEvents、TokenSupplyUpdates、Blocks、Transactions、TransactionBalances、DEXPools、TokenHolders、WalletTokenPnL
僅 Solana：
Instructions — 程式指令資料（程式地址、方法、賬戶、日誌）InstructionBalanceUpdates — 指令級別的餘額變動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 型別會包含 所有鏈欄位的並集 —— 每個 Cube 的 Record 中同時存在 MintAddress 與 SmartContract，底層資料一致。任意鏈上均可使用其中任一名稱。
| 概念 | 慣用（Solana） | 慣用（EVM） | 跨鏈通用？ |
|---|
| 代幣地址 | MintAddress | SmartContract | 各鏈均可 |
| 交易 ID | Signature / Hash | Hash | 各鏈均可 |
| 區塊標識 | Slot | Number | 各鏈均可 |
| 程式/合約 | ProgramAddress | SmartContract | 各鏈均可 |
| 手續費支付方 | FeePayer | From | 各鏈均可 |
因此你可以用 同一套查詢模板 跨鏈查詢而無需改欄位名。例如 Currency { MintAddress } 在 Solana 與 EVM 查詢中均可使用。
Trading
Trading 組提供 跨鏈預聚合 的交易分析資料。它將各支援鏈的資料合併為統一物化檢視，並透過 chain 維度做篩選。
Cubes
Pairs — OHLC K 線（開高低收、成交量、成交筆數）Tokens — 按代幣的交易統計（成交量、買賣拆分、獨立交易者數）
與 EVM / Solana 組的主要區別
- 無
network 引數 — Trading 組跨鏈彙總資料，請在資料內用 chain 維度按網路過濾。
- 跨鏈資料 — 單次查詢可同時返回
sol、eth、bsc 等。
- 預聚合 — 資料來自 DWM 層，按分鐘粒度物化。
示例：跨鏈 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 }
}
}
}
鏈組對比
| 特性 | 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） | 逐事件 + 指令級 | 預聚合（DWM） |
dataset 支援 | 是（多數 Cube） | 是（多數 Cube） | 是 |
aggregates 支援 | 是 | 是 | 是 |
相關文件
資料 Cubes
全部 25 個 Cube 的欄位結構與使用場景詳解。
Dataset 與 Aggregates
控制資料來源範圍與預聚合行為。
