Pagination

Most list endpoints use limit + cursor pagination.

Default and maximum page sizes

Default `limit`	Max `limit`	Endpoints
`20`	`100`	List markets, List events, Search
`50`	`100`	List orders, List trades, List redeems, margin position/request/settlement lists, public market trades, market margin activity
`50`	`200`	List account assets

Requests above the max return 400 with invalid_request_params on the limit field.

Query Parameters

integer

Number of rows per page (minimum 1). See the table above for per-endpoint defaults and maximums.

string

Opaque token returned from the previous page’s meta.next_cursor.

Response Metadata

List responses include:

Field	Type	Description
`limit`	`integer`	The page size used for this response
`next_cursor`	`string \| null`	Cursor for the next page. `null` means there are no further rows.

Cursor payload keys (opaque but documented)

Cursors are base64url-encoded JSON objects. The API may use different keys per endpoint:

Key	Endpoints
`before_id`	Keyset pagination by descending id: List orders, List redeems, public market trades, market margin activity, user trades. Also List markets and List events when `sort` is omitted.
`m_offset`	List markets when `sort` is set
`e_offset`	List events when `sort` is set
(opaque)	List margin positions, List position requests, List margin settlements. Merged Polymarket + Hyperliquid rows; request `sort` is `created` / `-created` only. Treat the whole cursor as opaque — do not decode it or rely on inner keys.
`o`	List account assets (row-scan offset; some balance rows are skipped)
(opaque)	Search

Always pass the next_cursor value back as the cursor query parameter unchanged. Some list endpoints return all rows in a single response and use an empty meta object (for example List API keys).

Example Flow

1) Initial request

GET /some/list/?limit=2

{
  "data": [ ... ],
  "meta": {
    "limit": 2,
    "next_cursor": "<opaque>",
  },
  "error": null
}

2) Follow-up request

Pass the previous meta.next_cursor as cursor unchanged:

GET /some/list/?limit=2&cursor=<opaque>

When next_cursor is null, pagination is complete.

Overview

Tools

Search

Sports

Markets

Events

Auth Keys

Orders

Trades

Account

Margin

Redeems

Default and maximum page sizes

Query Parameters

Response Metadata

Cursor payload keys (opaque but documented)

Example Flow

1) Initial request

2) Follow-up request

​Default and maximum page sizes

​Query Parameters

​Response Metadata

​Cursor payload keys (opaque but documented)

​Example Flow

​1) Initial request

​2) Follow-up request

Default and maximum page sizes

Query Parameters

Response Metadata

Cursor payload keys (opaque but documented)

Example Flow

1) Initial request

2) Follow-up request