next_cursor as the next request’s cursor. Keep the same filters and stop when has_more is false.
Combo fills sorted by largest or payout page by position instead: send the response’s next_offset as the next request’s offset.
Treat a cursor as an opaque string: save it, URL-encode it, and send it back unchanged. Do not construct a cursor or depend on its contents.
Read the response
Event replay keeps a
next_cursor even when caught up, so you can save it and ask for later events. That does not mean another page exists now.
Search content, Webhooks, and Webhook events return one bounded list. They have no cursor parameter and always return has_more: false.
Combo fills set has_more when a page comes back full, so the last page can be empty. With largest or payout, offset stops at 5,000: no next_offset past that is returned, and has_more is then false.
Choose a page size
Check the endpoint reference for its exact bounds. Live list endpoints clamp nonnegative whole-number limits into their supported range:
limit=0 becomes 1, and a value above the maximum becomes the maximum.
X-Effective-Query reports the applied limit. A non-integer limit returns 400 invalid_query; the sandbox also rejects numbers outside the schema’s bounds.
Send a cursor
Let your HTTP client encode the query parameters. Withcurl, use --data-urlencode:
Recover from an expired cursor
If a request returns400 with error.reason set to cursor_expired:
- Discard the cursor and the rows collected for that run.
- Request the first page with the same filters.
- Continue using the new cursors.
Retry-After is sent for this error. Waiting and resending the same cursor will not repair it.
Other 400 responses can indicate a malformed cursor or parameter. Read error.reason, error.param, and error.message before restarting.
Which cursors can expire
Some lists change while you read them. The following cursors are tied to a published ranking, a snapshot, or specific request parameters:
Edge Hunter advanced views return list envelopes with
data, has_more, and next_cursor. Use the same view, normalized selection, and filters on continuation requests. A replaced snapshot returns 400 cursor_expired; restart from page one.
Retired-route cursors cannot be reused.
Changed selections or filters on a valid advanced cursor also return 400 with error.reason: cursor_expired. Selected cursors from before the league identity correction must be restarted. Malformed or invalidly signed cursors return a generic 400 bad_request.
The default board still returns data.rows with up to 30 rows and no cursor. Its total can exceed the row count. The old pre-game sides and observations endpoints remain retired with 410 endpoint_retired.
Trade lists, positions, timelines, search, explore, webhook deliveries, and suspicious trades in mode=live use row-position cursors rather than the expiring rankings above. A cursor remaining valid does not freeze the underlying data.
Market-holder cursors identify an offset in a shared list and are bound to the market and filters. New cursors allow a different page size; older page-number cursors require their original size. They remain usable after the holder list refreshes.
Example: read all pages
This Python example followsnext_cursor, or next_offset on ranked combo fills. It restarts after an expired cursor and gives up after 3 attempts:
Limits
Most lists do not return a total count. A valid cursor does not promise an unchanged ranking. Apart from theoffset on ranked combo fills, there is no way to jump to a later page.
An offset counts positions in the ranking as it stands at each request. A fill that enters the ranking while you read can repeat a row you already have or move one past you, so deduplicate by id if that matters.
This handles pagination only. Add your application’s rate-limit handling before using it for a long-running job.