Cursor pagination

Cursor pagination

Cursor pagination adalah strategi paginasi yang menggunakan token opak (sebuah "cursor") untuk menandai posisi dalam himpunan hasil alih-alih bergantung pada offset numerik seperti page=2 atau offset=100. Klien mengirimkan kembali cursor ke server (misalnya melalui parameter after_cursor) untuk meminta halaman berikutnya. Server mengembalikan cursor baru untuk halaman selanjutnya dalam responsnya.

In context

Endpoint Gamma /markets milik Polymarket mengharuskan paginasi berbasis cursor: pemanggilan harus menggunakan nilai after_cursor yang dikembalikan oleh permintaan sebelumnya alih-alih parameter offset. Pendekatan bergaya keyset ini meningkatkan kinerja dan konsistensi pada himpunan hasil yang besar atau sering diperbarui karena server dapat melanjutkan dari posisi yang stabil tanpa harus memindai dari awal untuk setiap halaman. Gamma mengembalikan next_cursor dalam setiap respons yang dipaginasi; gunakan nilai itu sebagai after_cursor untuk mengambil halaman berikutnya.

Practical notes

• Opaque token: Perlakukan cursor sebagai string yang tidak diperiksa. Jangan mencoba mengurai atau membuatnya di sisi klien.
• No numeric offset: Gamma API menolak offset numerik; gunakan after_cursor untuk paginasi dengan /markets. Endpoint mendukung limit (maks 1000) bersamaan dengan after_cursor.
• Ordering matters: Cursor pagination terkait dengan pengurutan query. Jika Anda mengubah bidang urutan, Anda mungkin tidak dapat melanjutkan menggunakan cursor sebelumnya.
• Robust clients: Simpan cursor jika Anda berniat melanjutkan pemindaian panjang, dan tangani kasus di mana cursor yang sebelumnya dikeluarkan menjadi kadaluarsa atau tidak menghasilkan hasil apapun.

See also

• /glossary/gamma-api