Skip to main content

orderBy InputObject

每个 Cube 会生成 {Cube}OrderBy 输入对象,包含 ascendingdescending 字段。每个字段接受 CompareFields 枚举值,命名规则为维度路径以下划线连接:
嵌套维度逐级拼接:
用法:

常见 CompareFields 取值

GraphQL IDE 中用自动补全查看某 Cube 可用的全部 CompareFields——输入 orderBy: {descending: 后 IDE 会列出可选字段。

用法

传入 orderBy 输入对象,将 descendingascending 设为某个 CompareFields 值:
orderBy 仅接受单一方向/字段对。不支持多列排序——查询每次只按一个维度排序。

limit 参数

limit 控制返回行数,并支持基于 offset 的分页:

默认与最大限制

每个 Cube 在省略 limit 时有默认行数,并有最大上限:
若请求的 count 超过最大值,服务端会静默截断为最大允许值。

基于 Offset 的分页

使用 offset 翻页,模式很直接:
  • 第 1 页limit: { count: 50, offset: 0 }
  • 第 2 页limit: { count: 50, offset: 50 }
  • 第 3 页limit: { count: 50, offset: 100 }

示例:代币持有者分页

分页建议

没有稳定排序时,行间顺序可能在翻页时变化。请始终将 limit 与能产生确定顺序的 orderBy 一起使用。
很大的 offset(例如 50,000+)可能拖慢查询,因为数据库需扫描并跳过行。对超大结果集,优先用 where 收窄查询,而非深度 offset 翻页。
若某页返回行数少于请求的 count,说明已到达结果末尾。也可事先用 count 指标字段获取总行数。

实用示例

最新大额成交

获取 Solana 上最近 10 笔买入名义价值超过 10,000 美元的 DEX 成交:

OHLC K 线——最近 60 分钟

获取某代币 1 分钟 K 线,按时间正序:

Top 50 代币持有者

按 USD 余额排序取前 50 名持有者:

下一步

筛选

将排序与筛选结合,构建精确的分析查询。

指标与聚合

使用 count、sum、avg、min、max、uniq 对已排序数据聚合。