offset, no page number. Cursors stay stable as long as the sort order holds, so they beat offsets on live data.
The shape
A list response looks like this:next_cursor back as the cursor query param:
has_more is false.
Parameters
Full loop, end to end
This pulls every page of the leaderboard.Cursors are opaque
Don’t parse, construct, or store cursors long-term. Always use thenext_cursor from the response you just got.
Different endpoints encode cursors differently:
- Leaderboard:
{score}_{address} - Whale trades:
{timestamp}_{id}(ISO 8601) - Insider radar:
{score}_{id}
Gotchas
- Don’t mix cursors across filters. A cursor from
?category=cryptowon’t work on?category=politics. Restart pagination when filters change. - Don’t mix cursors across endpoints. A leaderboard cursor won’t work on whale trades.
400 Invalid cursor formatmeans the cursor came from a different filter set, a different endpoint, or got mangled. Drop it and start over.- Stale cursors expire. Pause for hours and the underlying sort can shift. Expect to restart.