跳转到主要内容

​
概述

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区块链
ethEthereum
bscBNB Chain (BSC)
polygonPolygon
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）跨链通用？
代币地址MintAddressSmartContract各链均可
交易 IDSignature / HashHash各链均可
区块标识SlotNumber各链均可
程序/合约ProgramAddressSmartContract各链均可
手续费支付方FeePayerFrom各链均可
因此你可以用 同一套查询模板 跨链查询而无需改字段名。例如 Currency { MintAddress } 在 Solana 与 EVM 查询中均可使用。

​
Trading

Trading 组提供 跨链预聚合 的交易分析数据。它将各支持链的数据合并为统一物化视图，并通过 chain 维度做筛选。

​
Cubes

  • Pairs — OHLC K 线（开高低收、成交量、成交笔数）
  • Tokens — 按代币的交易统计（成交量、买卖拆分、独立交易者数）

​
与 EVM / Solana 组的主要区别

  1. 无 network 参数 — Trading 组跨链汇总数据，请在数据内用 chain 维度按网络过滤。
  2. 跨链数据 — 单次查询可同时返回 sol、eth、bsc 等。
  3. 预聚合 — 数据来自 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 }
    }
  }
}

​
链组对比

特性EVMSolanaTrading
network 参数必填（eth、bsc、polygon）可选（solana，默认 solana）不需要（跨链）
独有 CubeEvents、Calls、MinerRewards、Uncles、DEXPoolSlippages、Prediction*Instructions、InstructionBalanceUpdates、Rewards、DEXOrdersPairs、Tokens
数据粒度逐事件（DWD）+ 聚合（DWM/DWS）逐事件 + 指令级预聚合（DWM）
dataset 支持是（多数 Cube）是（多数 Cube）是
aggregates 支持是是是

​
相关文档

数据 Cubes

全部 25 个 Cube 的字段结构与使用场景详解。

Dataset 与 Aggregates

控制数据源范围与预聚合行为。