Skip to main content
GET
Endpoints under pools-main-page power the main feed: sorted lists, King of the Hill, text search, and “following” lists. Auth: Public

​
GET /v1/pools-main-page/initial/state

Returns the initial page of pools for the selected filter.

​
Query parameters

​
string
required
Enum (exact match): New, Latest, CompletedCreateOn, CompletedMCap, MCapDesc.

​
Response

JSON array of LiquidityPoolInfo objects — each includes pool, metrics, and info (same shape as Pools feed — initial state).

​
GET /v1/pools-main-page/koth

Returns the current King of the Hill pool (highest market cap) as a single LiquidityPoolInfo.

​
GET /v1/pools-main-page/search

Paginated search for pools by name, ticker, or asset id.

​
Query parameters

​
string
required
Non-empty search string; backslashes are not allowed.
​
integer
Items to skip (default 0).
​
integer
Page size (default 100, max 100).

​
Response

{ "count": number, "items": LiquidityPoolInfo[] }

​
POST /v1/following

Returns paginated pools for a list of asset IDs the user follows.

​
Query parameters

Paging: offset, limit (default limit 60, max 60).

​
Body

JSON array of asset id strings (non-empty), e.g. ["policy.hexasset", "..."].

​
Response

Same Items shape as search.

​
Example

​
POST /v1/following/list

Same as POST /v1/following but returns all matching pools in one response (no pagination).

​
WebSocket

Subscribe to main-page feed topics (Latest, New, MCapDesc, CompletedCreateOn, CompletedMCap) after loading HTTP initial state. See WebSocket.