Skip to main content
GET
/
v1
/
pools-main-page
/
initial
/
state
curl -sS "https://analytics.snek.fun/v1/pools-main-page/initial/state?filter=Latest"
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

​
filter
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). 
curl -sS "https://analytics.snek.fun/v1/pools-main-page/initial/state?filter=Latest"

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

Returns the current King of the Hill pool (highest market cap) as a single LiquidityPoolInfo. 
curl -sS "https://analytics.snek.fun/v1/pools-main-page/koth"

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

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

​
Query parameters

​
pattern
string
required
Non-empty search string; backslashes are not allowed.
​
offset
integer
Items to skip (default 0).
​
limit
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

curl -sS -X POST "https://analytics.snek.fun/v1/following?offset=0&limit=20" \
  -H "Content-Type: application/json" \
  -d '["fbd4d3c334063ac19566f6ba39b6ec707ea91fa81d0c09201575c10b.44415645"]'

​
POST /v1/following/list

Same as POST /v1/following but returns all matching pools in one response (no pagination). 
curl -sS -X POST "https://analytics.snek.fun/v1/following/list" \
  -H "Content-Type: application/json" \
  -d '["fbd4d3c334063ac19566f6ba39b6ec707ea91fa81d0c09201575c10b.44415645"]'

​
WebSocket

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