池与流动性

DEX 池与流动性数据的查询示例

本文介绍用于 DEX 池子与流动性分析的 Cube：

• DEXPoolEvents（DWD）— 流动性添加/移除事件，含逐事件储备与价格
• DEXPools（DWS）— 池子快照（当前流动性与价格，定期刷新）
• TokenSupplyUpdates（DWD）— 代币供应量、市值与 FDV 更新

示例使用 Solana 与 EVM 链分组：Solana { ... } 用于 Solana，EVM(network: eth | bsc | polygon) { ... } 用于 EVM 链（含 Polygon）。

---

​

如何获取某代币的流动性池？

在快照中查找将某代币列为 token A 的 DEX 池子。若资产仅作为 token B 出现，需用 tokenB 再查一次（或使用 where）；需要事件级行与完整交易对上下文时，请用 DEXPoolEvents。

query {
  Solana {
    DEXPools(
      limit: {count: 10}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool {
        Address
        ProgramAddress
        TokenAAddress
        TokenBAddress
        LiquidityUSD
        PriceAtoB
        PriceBtoA
        LastUpdated
      }
    }
  }
}

在 GraphQL IDE 中打开 — 将上方查询粘贴进去即可交互运行，并享受自动补全与 schema 浏览。

将 TOKEN_ADDRESS 替换为代币 mint（Solana）或合约地址（EVM）。再用 tokenB: {is: "TOKEN_ADDRESS"} 查询一次，可包含该代币作为报价侧的池子。

关键字段

字段	说明
Pool.Address	流动性池 / 市场地址
Pool.ProgramAddress	DEX 程序或工厂合约地址
Pool.TokenAAddress	基础侧代币地址
Pool.TokenBAddress	报价侧代币地址
Pool.LiquidityUSD	池子总流动性（USD，快照）
Pool.LastUpdated	该快照行上次更新时间

自定义提示

• 按流动性过滤：添加 where: {Pool: {LiquidityUSD: {gt: 10000}}} 筛选超过某 USD 深度的池子
• 指定 DEX：添加 where: {Pool: {ProgramAddress: {is: "DEX_PROGRAM_OR_FACTORY_ADDRESS"}}}
• 更多池子：提高 count 以发现该代币的更多池子
• 逐事件储备：对 DEXPoolEvents 使用 tokenAddress / poolAddress 与 orderBy: {descending: Block_Time} 查看加/减流动性历史

---

​

如何获取某个池子的详情？

按地址读取单个池子的最新快照。DEXPools 不按行暴露区块时间线 — 历史储备序列请用 DEXPoolEvents。

query {
  Solana {
    DEXPools(
      limit: {count: 1}
      poolAddress: {is: "POOL_ADDRESS"}
    ) {
      Pool {
        Address
        TokenAAddress
        TokenBAddress
        ProgramAddress
        LiquidityUSD
        PriceAtoB
        PriceBtoA
        LastUpdated
      }
    }
  }
}

关键字段

字段	说明
Pool.TokenAAddress / Pool.TokenBAddress	交易对代币地址
Pool.LiquidityUSD	总流动性（USD，快照）
Pool.LastUpdated	该池快照上次刷新时间

自定义提示

• 储备历史：查询 DEXPoolEvents，poolAddress: {is: "POOL_ADDRESS"} 且 orderBy: {descending: Block_Time}
• 事件时间范围：在 DEXPoolEvents 上添加 where: {Block: {Time: {since: "2025-03-01T00:00:00Z"}}} 限定加/减流动性时段

poolAddress 选择器按 Pool.Address 过滤。DEXPools（快照）与 DEXPoolEvents（事件）均支持。

---

​

如何对池子排序或读取快照流动性？

DEXPools（DWS）存储当前状态行（通常每隔数分钟刷新）。可用其按 LiquidityUSD 对池子排序，并在不扫原始事件的情况下对比各 DEX 程序。

query {
  Solana {
    DEXPools(
      limit: {count: 20}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool {
        Address
        ProgramAddress
        TokenAAddress
        TokenBAddress
        LiquidityUSD
        LastUpdated
      }
    }
  }
}

关键字段

字段	说明
Pool.Address	池子地址
Pool.ProgramAddress	DEX 程序 / 工厂
Pool.TokenAAddress / Pool.TokenBAddress	交易对代币
Pool.LiquidityUSD	快照流动性（USD）
Pool.LastUpdated	快照新鲜度

自定义提示

• 按流动性排序：客户端按 LiquidityUSD 排序，或在 schema 支持时对池快照使用 orderBy
• 活跃池子：优先选择 LastUpdated 较新的池子
• 对比 DEX：按 Pool.ProgramAddress 分组或过滤

DEXPoolEvents（DWD）适合储备与每笔流动性事件的时间序列。DEXPools（DWS）针对最新池子状态与发现做了优化。

---

​

如何获取代币供应量与市值？

使用 TokenSupplyUpdates 获取与供应事件关联的供应量、市值、价格与 FDV。

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

关键字段

字段	说明
TokenSupplyUpdate.Currency.MintAddress	代币地址
TokenSupplyUpdate.Currency.Decimals	代币小数位
TokenSupplyUpdate.PostBalance	事件后的当前供应量
TokenSupplyUpdate.MarketCapInUSD	市值（USD）
TokenSupplyUpdate.PriceInUSD	供应事件发生时的代币价格
TokenSupplyUpdate.FDVInUSD	完全稀释估值（FDV）
TokenSupplyUpdate.TotalSupply	代币总供应量

自定义提示

• 供应历史：提高 count 查看供应量如何随时间变化（铸造/销毁事件）
• 市值历史：查询多条供应更新以绘制市值曲线
• 与价格结合：将 PriceInUSD 与 TotalSupply 联用以核对市值计算

本页通过 TokenSupplyUpdates 提供与供应相关的市值、价格与 FDV。更多代币指标与汇总见 OHLC 与统计。

---

​

多链示例

Solana

query {
  Solana {
    DEXPools(
      limit: {count: 5}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool { Address, LiquidityUSD, LastUpdated }
    }
  }
}

Ethereum

query {
  EVM(network: eth) {
    DEXPools(
      limit: {count: 5}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool { Address, LiquidityUSD, LastUpdated }
    }
  }
}

BSC

query {
  EVM(network: bsc) {
    DEXPools(
      limit: {count: 5}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool { Address, LiquidityUSD, LastUpdated }
    }
  }
}

Polygon

query {
  EVM(network: polygon) {
    DEXPools(
      limit: {count: 5}
      tokenA: {is: "TOKEN_ADDRESS"}
    ) {
      Pool { Address, LiquidityUSD, LastUpdated }
    }
  }
}

---

​

后续步骤

DEX 成交

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

转账

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

余额与持币者

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

OHLC 与统计

获取 K 线、成交统计、市值与代币元数据。