> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snek.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Main page feed

> Pool lists, KOTH, search, and following — analytics.snek.fun

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

<ParamField query="filter" type="string" required>
  Enum (exact match): `New`, `Latest`, `CompletedCreateOn`, `CompletedMCap`, `MCapDesc`.
</ParamField>

### Response

JSON array of `LiquidityPoolInfo` objects — each includes `pool`, `metrics`, and `info` (same shape as [Pools feed — initial state](/api-reference/snekfun-provider/http/pools-feed)).

<RequestExample>
  ```bash theme={null}
  curl -sS "https://analytics.snek.fun/v1/pools-main-page/initial/state?filter=Latest"
  ```
</RequestExample>

***

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

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

<RequestExample>
  ```bash theme={null}
  curl -sS "https://analytics.snek.fun/v1/pools-main-page/koth"
  ```
</RequestExample>

***

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

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

### Query parameters

<ParamField query="pattern" type="string" required>
  Non-empty search string; backslashes are not allowed.
</ParamField>

<ParamField query="offset" type="integer">
  Items to skip (default `0`).
</ParamField>

<ParamField query="limit" type="integer">
  Page size (default `100`, max `100`).
</ParamField>

### 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

```bash theme={null}
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).

```bash theme={null}
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](/api-reference/snekfun-provider/websocket).