Cursor pagination

Cursor pagination

Cursor pagination 是一种分页策略，它使用一个不透明的令牌（“游标”）来标记结果集中的位置，而不是依赖像 page=2 或 offset=100 这样的数字偏移。客户端将游标传回服务器（例如通过 after_cursor 参数）以请求下一页。服务器在响应中为下一页返回一个新的游标。

In context

Polymarket 的 Gamma /markets 端点要求基于游标的分页：调用必须使用先前请求返回的 after_cursor 值，而不是 offset 参数。这种键集（keyset）风格的方法在大型或频繁更新的结果集中提升了性能和一致性，因为服务器可以从一个稳定的位置继续，而无需为每一页从头扫描。Gamma 在每个分页响应中返回 next_cursor；将该值作为 after_cursor 提供以获取后续页面。

Practical notes

• 不透明令牌：将游标视为不可检查的字符串。不要在客户端尝试解析或构造它。
• 无数字偏移：Gamma API 拒绝数字偏移；在 /markets 上使用 after_cursor 进行分页。该端点支持与 after_cursor 一起使用的 limit（最大 1000）。
• 排序很重要：游标分页与查询的排序绑定。如果你更改了排序字段，可能无法使用先前的游标继续扫描。
• 健壮的客户端：如果你打算恢复长时间扫描，请保存游标，并处理先前签发的游标失效或未返回结果的情况。

See also

• /glossary/gamma-api