Définition
Cursor pagination
Une stratégie de pagination qui utilise des jetons opaques au lieu d'offsets numériques.
Cursor pagination
La cursor pagination est une stratégie de pagination qui utilise un jeton opaque (un « cursor ») pour marquer une position dans un jeu de résultats au lieu de s'appuyer sur des offsets numériques comme page=2 ou offset=100. Les clients renvoient le cursor au serveur (par exemple via un paramètre after_cursor) pour demander la page suivante. Le serveur renvoie un nouveau cursor pour la page suivante dans sa réponse.
Dans le contexte
L'endpoint Gamma /markets de Polymarket exige une pagination basée sur des cursors : les appels doivent utiliser la valeur after_cursor renvoyée par une requête précédente plutôt qu'un paramètre offset. Cette approche de type keyset améliore les performances et la cohérence sur des jeux de résultats volumineux ou fréquemment mis à jour, car le serveur peut reprendre à partir d'une position stable sans scanner depuis le début à chaque page. Gamma renvoie un next_cursor dans chaque réponse paginée ; fournissez cette valeur comme after_cursor pour récupérer la page suivante.
Remarques pratiques
- Jeton opaque : Traitez le cursor comme une chaîne non inspectée. N'essayez pas de l'analyser ou de le construire côté client.
- Pas d'offset numérique : l'API Gamma rejette les offsets numériques ; utilisez after_cursor pour la pagination avec /markets. L'endpoint accepte limit (max 1000) en parallèle de after_cursor.
- L'ordre compte : la cursor pagination est liée à l'ordre de la requête. Si vous changez les champs d'ordre, vous pourriez ne pas pouvoir reprendre avec un cursor précédent.
- Clients robustes : enregistrez les cursors si vous prévoyez de reprendre un balayage long, et gérez le cas où un cursor précédemment émis devient obsolète ou ne renvoie aucun résultat.
Voir aussi
- /glossary/gamma-api