> ## 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. # OHLC 与统计 > K 线数据（Pairs）、单代币交易统计（Tokens）、供应与估值（TokenSupplyUpdates）的查询示例，以及在哪里查找代币元数据 本页介绍聚合交易与供应数据。**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。 ```graphql theme={null} 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 中打开](https://ide.chainstream.io) — 粘贴上方查询即可交互运行，并享受自动补全与 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。 ```graphql theme={null} 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.Usd` | USD 总成交量 | | `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 ```graphql theme={null} 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 为例） ```graphql theme={null} 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)`（或其他支持的网络）下运行相同结构 * **更多上下文**：另见 [池子与流动性](/cn/graphql/examples/pools-liquidity#how-do-i-get-token-supply-and-market-cap) 中与供应量及池子相关的示例 **TokenSupplyUpdates** 为 **DWD**（事件级）。适合与铸币/销毁相关的历史估值与供应变化，而不是单一静态「市值」汇总行。 *** ## 代币搜索 / 元数据在哪里？ **TokenSearch** Cube **不是**当前 API 的一部分。获取代币上下文时： * **Pairs** 与 **Tokens** 暴露 **Token** 维度（例如 **Token.Address**），与 OHLC 和统计并列 — 在已知地址且需要聚合交易数据时使用。 * 需要更丰富的元数据、持有人数、池子或发现能力时，在 **Solana** 或 **EVM** 下使用 **DEXPools**、**TokenHolders**、**DEXTradeByTokens** 等 Cube，视链而定。 *** ## 多链示例 ```graphql theme={null} 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 } } } } ``` ```graphql theme={null} query { Trading { Pairs( tokenAddress: { is: "TOKEN_ADDRESS" } where: { Market: { Network: { is: "eth" } } } limit: { count: 10 } orderBy: { descending: Block_Time } ) { Interval { Time { Start } } Price { Ohlc { Open Close } } Volume { Usd } } } } ``` ```graphql theme={null} query { Trading { Pairs( tokenAddress: { is: "TOKEN_ADDRESS" } where: { Market: { Network: { is: "bsc" } } } limit: { count: 10 } orderBy: { descending: Block_Time } ) { Interval { Time { Start } } Price { Ohlc { Open Close } } Volume { Usd } } } } ``` *** ## 下一步 查询 DEX 交易数据 — 代币成交、钱包活动与头部交易者。 追踪链上钱包之间的代币转账。 查询钱包余额、余额历史与头部持有人。 探索 DEX 池子与流动性数据。