カーソルページネーション

カーソルページネーションは、page=2 や offset=100 のような数値オフセットに頼る代わりに、不透明なトークン（「カーソル」）を使って結果セット内の位置を示すページネーション方式です。クライアントは次のページを要求する際にそのカーソルをサーバーに渡します（たとえば after_cursor パラメータ経由）。サーバーは応答内で次のページ用の新しいカーソルを返します。

文脈

Polymarket の Gamma /markets エンドポイントはカーソルベースのページネーションを要求します：呼び出しでは offset パラメータではなく前回のリクエストで返された after_cursor の値を使う必要があります。このキーセット方式は、大規模または頻繁に更新される結果セットで、サーバーが各ページのために先頭からスキャンすることなく安定した位置から再開できるため、パフォーマンスと一貫性を改善します。Gamma は各ページネーションされたレスポンスで next_cursor を返します；次のページを取得するにはその値を after_cursor として指定してください。

実用的な注意

不透明トークン: カーソルは検査しない文字列として扱ってください。クライアント側で解析したり作成しようとしないでください。
数値オフセットは不可: Gamma API は数値オフセットを拒否します；/markets のページネーションには after_cursor を使用してください。エンドポイントは after_cursor と併用できる limit（最大 1000）をサポートします。
並び順が重要: カーソルページネーションはクエリの並び順に結びついています。並び順のフィールドを変更すると、以前のカーソルで再開できない場合があります。
頑強なクライアント: 長いスキャンを再開する予定がある場合はカーソルを保存し、以前発行したカーソルが古くなるか結果を返さない場合に対応する処理を実装してください。

関連用語