Cursor pagination

Cursor pagination

Cursor pagination은 결과 집합에서 위치를 표시하기 위해 숫자 오프셋(page=2 또는 offset=100 등) 대신 불투명한 토큰(“커서”)을 사용하는 페이지매김 전략입니다. 클라이언트는 다음 페이지를 요청할 때 커서 값을 서버에 전달합니다(예: after_cursor 파라미터를 통해). 서버는 응답에 다음 페이지를 위한 새 커서를 반환합니다.

In context

Polymarket의 Gamma /markets 엔드포인트는 커서 기반 페이지매김을 요구합니다: 호출은 offset 파라미터 대신 이전 요청에서 반환된 after_cursor 값을 사용해야 합니다. 이 키셋 방식은 서버가 각 페이지마다 처음부터 스캔하지 않고 안정된 위치에서 재개할 수 있기 때문에, 대용량이거나 자주 업데이트되는 결과 집합에서 성능과 일관성을 개선합니다. Gamma는 각 페이징된 응답에 next_cursor를 반환합니다; 이후 페이지를 가져오려면 해당 값을 after_cursor로 제공하세요.

Practical notes

• Opaque token: 커서를 검사하지 않은 문자열로 취급하세요. 클라이언트 측에서 파싱하거나 생성하려고 시도하지 마세요.
• No numeric offset: Gamma API는 숫자형 offset을 거부합니다; /markets 페이징에는 after_cursor를 사용하세요. 이 엔드포인트는 after_cursor와 함께 limit(최대 1000)을 지원합니다.
• Ordering matters: 커서 페이지매김은 쿼리의 정렬에 묶여 있습니다. 정렬 필드를 변경하면 이전 커서를 사용해 재개할 수 없을 수 있습니다.
• Robust clients: 긴 스캔을 재개하려면 커서를 저장하고, 이전에 발급된 커서가 오래되었거나 결과를 반환하지 않는 경우를 처리하세요.

See also

• /glossary/gamma-api