跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt

Use this file to discover all available pages before exploring further.

本页介绍聚合交易与供应数据。Cube 名称为 Trading 链组中的 Pairs 与 Tokens（跨链 OHLC 与成交统计）。市值与价格随时间变化来自 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）蜡烛图数据？

按代币拉取蜡烛图数据 — 每分钟的开、高、低、收价格，以及 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 中打开 — 粘贴上方查询即可交互运行，并享受自动补全与 schema 浏览。
将 TOKEN_ADDRESS 替换为代币 mint 或合约地址。每一行对应一分钟桶 — 使用 limit: { count: 60 } 约一小时，count: 1440 约 24 小时。省略 Market 筛选可在单次结果中跨所有链查询。
字段说明
Interval.Time.Start分钟桶起始时间（与蜡烛时间一致）
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 请求更多行，或在客户端聚合；蜡烛以分钟粒度存储
  • 成交量筛选：例如 where: { Volume: { Usd: { gt: 100 } }, Market: { Network: { is: "sol" } } } 以跳过低成交量区间
  • 时间范围：例如 where: { Block: { Time: { since: "2026-03-27T00:00:00Z" } }, Market: { Network: { is: "sol" } } }
Pairs Cube 为 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 }
    }
  }
}
字段说明
Interval.Time.Start分钟桶起始时间（与蜡烛时间一致）
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）制图
  • 买卖成交量：需要 USD 拆分时，Tokens 记录还提供 Volume.BuyVolumeUSD 与 Volume.SellVolumeUSD
对同一代币、链与时间窗口同时查询 Pairs 与 Tokens，可搭建仪表盘 — OHLC 与资金流、参与者指标并列展示。

​
如何获取市值、价格与供应量随时间变化？

当前 schema 不再使用旧的 TokenMarketCap 汇总 Cube。请使用 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 }
    }
  }
}
字段说明
Block.Time事件时间
TokenSupplyUpdate.Currency.*代币标识（mint/合约、小数位、符号、名称）
TokenSupplyUpdate.PriceInUSD本次更新时的 USD 价格
TokenSupplyUpdate.MarketCapInUSD市值
TokenSupplyUpdate.TotalSupply总供应量
TokenSupplyUpdate.FDVInUSD完全稀释估值（FDV）
TokenSupplyUpdate.PostBalance事件后的供应相关余额
  • 最新快照：limit: { count: 1 } 配合 orderBy: { descending: Block_Time }
  • 跨链对比：在 Solana 与 EVM(network: bsc)（或其他支持的网络）下运行相同结构
  • 更多上下文：另见 池子与流动性 中与供应量及池子相关的示例
TokenSupplyUpdates 为 DWD（事件级）。适合与铸币/销毁相关的历史估值与供应变化，而不是单一静态「市值」汇总行。

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

TokenSearch Cube 不是当前 API 的一部分。获取代币上下文时：
  • Pairs 与 Tokens 暴露 Token 维度（例如 Token.Address），与 OHLC 和统计并列 — 在已知地址且需要聚合交易数据时使用。
  • 需要更丰富的元数据、持有人数、池子或发现能力时，在 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 成交

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

转账

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

余额与持有人

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

池子与流动性

探索 DEX 池子与流动性数据。