Cursor pagination

Cursor pagination

Cursor pagination es una estrategia de paginación que usa un token opaco (un "cursor") para marcar una posición en un conjunto de resultados en lugar de confiar en offsets numéricos como page=2 u offset=100. Los clientes envían el cursor de vuelta al servidor (por ejemplo mediante el parámetro after_cursor) para solicitar la página siguiente. El servidor devuelve un nuevo cursor para la página siguiente en su respuesta.

En contexto

El endpoint Gamma /markets de Polymarket requiere paginación basada en cursor: las llamadas deben usar el valor after_cursor devuelto por una petición previa en lugar de un parámetro offset. Este enfoque estilo keyset mejora el rendimiento y la consistencia en conjuntos de resultados grandes o que se actualizan con frecuencia porque el servidor puede reanudar desde una posición estable sin escanear desde el inicio en cada página. Gamma devuelve un next_cursor en cada respuesta paginada; suministra ese valor como after_cursor para obtener la página siguiente.

Notas prácticas

• Token opaco: Trata el cursor como una cadena no inspeccionada. No intentes parsearlo ni construirlo en el cliente.
• Sin offset numérico: la Gamma API rechaza offsets numéricos; usa after_cursor para paginar con /markets. El endpoint admite limit (max 1000) junto con after_cursor.
• El orden importa: la paginación por cursor está ligada al orden de la consulta. Si cambias los campos de orden es posible que no puedas reanudar usando un cursor previo.
• Clientes robustos: guarda los cursores si planeas reanudar un escaneo largo y maneja el caso en que un cursor previamente emitido quede obsoleto o no devuelva resultados.

Véase también

• /glossary/gamma-api