跳转到主要内容
本页介绍聚合交易与供应类数据。Cube 名称为 Trading 链组下的 Pairs（跨链 OHLC）与 Tokens（跨链成交统计）。市值与价格随时间变化请用 Solana 或 EVM 下的 TokenSupplyUpdates。
  • Pairs（Trading，DWM）— 每分钟 K 线（OHLC、成交量、成交笔数）
  • Tokens（Trading，DWM）— 每分钟成交统计（买卖拆分、独立买卖方数量）
  • TokenSupplyUpdates（Solana / EVM，DWD）— 铸币/销毁等事件，含供应量、价格、市值、FDV 等字段
  • 代币元数据 — 已无独立 TokenSearch Cube；可在 Pairs / Tokens 上通过 Token 等维度查看与交易相关的上下文，或用 DEXPools、TokenHolders、DEXTradeByTokens 等 Cube 做发现与筛选
Trading 链组 没有 network 参数。请用 where: { Market: { Network: { is: "sol" } } }（或 eth、bsc、polygon）限定链。Solana 与 EVM 仍使用原有包装：Solana { ... }、EVM(network: eth) { ... }。

​
如何获取 K 线（OHLC）数据？

按分钟获取 open / high / low / close、USD 成交量与成交笔数。在 Trading 下使用 Pairs Cube。 
query {
  Trading {
    Pairs(
      tokenAddress: { is: "TOKEN_ADDRESS" }
      where: { Market: { Network: { is: "sol" } } }
      limit: { count: 24 }
      orderBy: { descending: Block_Time }
    ) {
      Interval { Time { Start } }
      Token { Address }
      Market { Network }
      Price {
        Ohlc {
          Open
          High
          Low
          Close
        }
      }
      Volume { Usd }
      Stats { TradeCount }
    }
  }
}
在 GraphQL IDE 中打开 — 将上方查询粘贴到 IDE 中即可交互式运行，享受自动补全与 Schema 探索。
将 TOKEN_ADDRESS 替换为代币 mint 或合约地址。每一行对应一个分钟桶 — limit: { count: 60 } 约 1 小时，count: 1440 约 24 小时。去掉 Market 过滤可在单次查询中跨链返回数据。
FieldDescription
Interval.Time.Start分钟桶起始时间（与 K 线时间一致）
Token.Address代币地址
Market.Network链标识（sol、eth、bsc 等）
Price.Ohlc.Open区间开盘价
Price.Ohlc.High区间最高价
Price.Ohlc.Low区间最低价
Price.Ohlc.Close区间收盘价
Volume.Usd该区间 USD 成交总额
Stats.TradeCount该区间成交笔数
  • 更长周期：增大 limit 或在客户端聚合；K 线以分钟粒度物化存储
  • 成交量过滤：例如 where: { Volume: { Usd: { gt: 100 } }, Market: { Network: { is: "sol" } } } 跳过低量区间
  • 时间范围：例如 where: { Block: { Time: { since: "2026-03-27T00:00:00Z" } }, Market: { Network: { is: "sol" } } }
Pairs 属于 DWM（聚合）模型 — 数据按分钟预计算，做图表远比扫原始成交高效。

​
如何获取代币成交统计？

按分钟获取买卖笔数、独立买卖方数量与成交量。在 Trading 下使用 Tokens Cube。 
query {
  Trading {
    Tokens(
      tokenAddress: { is: "TOKEN_ADDRESS" }
      where: { Market: { Network: { is: "sol" } } }
      limit: { count: 24 }
      orderBy: { descending: Block_Time }
    ) {
      Interval { Time { Start } }
      Token { Address }
      Market { Network }
      Stats {
        TradeCount
        BuyCount
        SellCount
        UniqueBuyers
        UniqueSellers
      }
      Volume { Usd }
    }
  }
}
FieldDescription
Interval.Time.Start分钟桶起始时间（与 K 线时间一致）
Stats.TradeCount该区间总成交笔数
Stats.BuyCount买入侧成交笔数
Stats.SellCount卖出侧成交笔数
Volume.UsdUSD 成交总额
Stats.UniqueBuyers独立买方钱包数
Stats.UniqueSellers独立卖方钱包数
  • 买卖压力：对比 Stats.BuyCount 与 Stats.SellCount
  • 独立交易者：Stats.UniqueBuyers 与 Stats.UniqueSellers 反映量是分散还是集中
  • 活动热力图：拉满一天（count: 1440）并按 Interval.Time.Start（或 Block.Time）作图
  • 买卖成交额拆分：Tokens 记录还提供 Volume.BuyVolumeUSD、Volume.SellVolumeUSD 等字段
对同一代币、同一链、同一时间窗口同时查 Pairs 与 Tokens，可搭建看板 — K 线与资金流向、参与者指标并用。

​
如何获取市值、价格与供应量（时间序列）？

旧版 TokenMarketCap 摘要 Cube 已不在当前 Schema 中。请使用 TokenSupplyUpdates（Solana 或 EVM）：每一行对应一次影响供应的事件，TokenSupplyUpdate 中含价格、市值、FDV、总供应等。

​
Solana

query {
  Solana {
    TokenSupplyUpdates(
      tokenAddress: { is: "TOKEN_ADDRESS" }
      limit: { count: 24 }
      orderBy: { descending: Block_Time }
    ) {
      Block { Time }
      TokenSupplyUpdate {
        Currency {
          MintAddress
          Decimals
          Symbol
          Name
        }
        PriceInUSD
        MarketCapInUSD
        TotalSupply
        FDVInUSD
        PostBalance
      }
      Transaction { Signature }
    }
  }
}

​
EVM（以 Ethereum 为例）

query {
  EVM(network: eth) {
    TokenSupplyUpdates(
      tokenAddress: { is: "TOKEN_ADDRESS" }
      limit: { count: 24 }
      orderBy: { descending: Block_Time }
    ) {
      Block { Time }
      TokenSupplyUpdate {
        Currency {
          MintAddress
          Decimals
          Symbol
          Name
        }
        PriceInUSD
        MarketCapInUSD
        TotalSupply
        FDVInUSD
        PostBalance
      }
      Transaction { Hash }
    }
  }
}
FieldDescription
Block.Time事件发生时间
TokenSupplyUpdate.Currency.*代币标识（mint/合约、小数位、符号、名称）
TokenSupplyUpdate.PriceInUSD该次更新时的 USD 价格
TokenSupplyUpdate.MarketCapInUSD市值
TokenSupplyUpdate.TotalSupply总供应量
TokenSupplyUpdate.FDVInUSD完全稀释估值
TokenSupplyUpdate.PostBalance事件后的供应相关余额
  • 最新快照：limit: { count: 1 } 且 orderBy: { descending: Block_Time }
  • 跨链对比：在 Solana 与 EVM(network: bsc)（或其他受支持网络）下使用相同查询结构
  • 更多上下文：另见 Pools & Liquidity 中的供应与池子相关示例
TokenSupplyUpdates 属于 DWD（事件明细）。适合与铸币/销毁相关的历史估值与供应变化，而不是单一的静态「市值」摘要行。

​
代币搜索 / 元数据在哪里？

当前 API 不包含 TokenSearch Cube。获取代币上下文可以：
  • 在已知地址的前提下，通过 Pairs、Tokens 上的 Token 维度（例如 Token.Address）与聚合交易数据一起查询。
  • 需要更丰富的元数据、持有者、池子或发现能力时，在 Solana 或 EVM 下使用 DEXPools、TokenHolders、DEXTradeByTokens 等 Cube。

​
多链示例

query {
  Trading {
    Pairs(
      tokenAddress: { is: "TOKEN_ADDRESS" }
      where: { Market: { Network: { is: "sol" } } }
      limit: { count: 10 }
      orderBy: { descending: Block_Time }
    ) {
      Interval { Time { Start } }
      Price {
        Ohlc {
          Open
          Close
        }
      }
      Volume { Usd }
    }
  }
}

​
下一步

DEX Trades

查询 DEX 交易数据 — 代币交易、钱包活动与头部交易者。

Transfers

追踪钱包间的链上代币转账。

Balances & Holders

查询钱包余额、余额历史与头部持有者。

Pools & Liquidity

探索 DEX 池与流动性数据。