Cursor pagination

Cursor pagination

Ang Cursor pagination ay isang estratehiya ng pagination na gumagamit ng opaque token (tinatawag na "cursor") para markahan ang isang posisyon sa isang result set sa halip na umasa sa numeric offsets tulad ng page=2 o offset=100. Ipinapasa ng kliyente ang cursor pabalik sa server (halimbawa sa pamamagitan ng parameter na after_cursor) para humiling ng susunod na pahina. Nagbabalik ang server ng bagong cursor para sa kasunod na pahina sa tugon nito.

In context

Ang Gamma /markets endpoint ng Polymarket ay nangangailangan ng cursor-based pagination: dapat gamitin ng mga tawag ang after_cursor value na ibinalik ng naunang request sa halip na offset parameter. Pinapabuti ng ganitong keyset-style na paraan ang performance at konsistensya sa malalaking result set o madalas na ina-update na data dahil maaaring ipagpatuloy ng server mula sa isang matatag na posisyon nang hindi nagsisimula sa simula para sa bawat pahina. Nagbabalik ang Gamma ng next_cursor sa bawat pag-paginate na tugon; ibigay ang halagang iyon bilang after_cursor para kunin ang kasunod na pahina.

Practical notes

• Opaque token: Ituring ang cursor bilang isang hindi sinisiyasat na string. Huwag subukang i-parse o buuin ito sa client-side.
• No numeric offset: Tinatanggihan ng Gamma API ang numeric offset; gamitin ang after_cursor para sa pagination sa /markets. Sinusuportahan ng endpoint ang limit (max 1000) kasabay ng after_cursor.
• Ordering matters: Nakaugnay ang cursor pagination sa ordering ng query. Kung babaguhin mo ang mga order field maaaring hindi mo magawang ipagpatuloy ang paggamit ng dating cursor.
• Robust clients: I-save ang mga cursor kung balak mong ipagpatuloy ang isang mahabang scan, at asikasuhin ang kaso kung saan nagiging stale ang dating ibinigay na cursor o walang naibabalik na resulta.

See also

• /glossary/gamma-api