OHLC 与统计

本页介绍聚合交易与供应数据。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.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

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，视链而定。

多链示例

Solana (Trading)
Ethereum (Trading)
BSC (Trading)

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 }
    }
  }
}

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 }
    }
  }
}

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 交易数据 — 代币成交、钱包活动与头部交易者。

转账

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

余额与持有人

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

池子与流动性

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

快速开始

GraphQL IDE

Schema 与数据模型

查询示例

计费与额度

如何获取 K 线（OHLC）蜡烛图数据？

如何获取某代币的成交统计？

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

Solana

EVM（以 Ethereum 为例）

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

多链示例

下一步

DEX 成交

转账

余额与持有人

池子与流动性

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

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

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

​Solana

​EVM（以 Ethereum 为例）

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

​多链示例

​下一步

DEX 成交

转账

余额与持有人

池子与流动性

如何获取 K 线（OHLC）蜡烛图数据？

如何获取某代币的成交统计？

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

Solana

EVM（以 Ethereum 为例）

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

多链示例

下一步