Cursor pagination

Cursor pagination

Cursor pagination ist eine Paginierungsstrategie, die ein undurchsichtiges Token (ein „Cursor“) verwendet, um eine Position in einem Ergebnisset zu markieren, anstatt sich auf numerische Offsets wie page=2 oder offset=100 zu stützen. Clients geben den Cursor an den Server zurück (zum Beispiel über einen after_cursor-Parameter), um die nächste Seite anzufordern. Der Server liefert in seiner Antwort einen neuen Cursor für die folgende Seite.

In context

Polymarkets Gamma /markets-Endpunkt verlangt Cursor-basierte Paginierung: Aufrufe müssen den after_cursor-Wert verwenden, der von einer vorherigen Anfrage zurückgegeben wurde, anstatt eines offset-Parameters. Dieser Keyset-ähnliche Ansatz verbessert die Leistung und Konsistenz bei großen oder häufig aktualisierten Ergebnissets, weil der Server von einer stabilen Position fortsetzen kann, ohne für jede Seite neu vom Anfang scannen zu müssen. Gamma gibt in jeder paginierten Antwort ein next_cursor zurück; übergeben Sie diesen Wert als after_cursor, um die nächste Seite abzurufen.

Practical notes

• Undurchsichtiges Token: Behandeln Sie den Cursor als unveränderten String. Versuchen Sie nicht, ihn clientseitig zu parsen oder zu konstruieren.
• Kein numerisches Offset: Die Gamma-API lehnt numerische Offsets ab; verwenden Sie after_cursor für die Paginierung mit /markets. Der Endpunkt unterstützt limit (max 1000) zusammen mit after_cursor.
• Reihenfolge ist relevant: Cursor-Paginierung ist an die Sortierung der Abfrage gebunden. Wenn Sie die Order-Felder ändern, können Sie möglicherweise nicht mit einem vorherigen Cursor weitermachen.
• Robuste Clients: Speichern Sie Cursor, wenn Sie einen langen Scan fortsetzen wollen, und behandeln Sie den Fall, dass ein zuvor ausgegebener Cursor veraltet ist oder keine Ergebnisse zurückliefert.

See also

• /glossary/gamma-api