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

# Pools feed

> Single-token pool snapshot and bonding curve progress

Use these endpoints after you know the token `asset` id. For live updates, subscribe to the **PoolFeed** WebSocket topic — see [WebSocket](/api-reference/snekfun-provider/websocket).

**Auth:** Public

***

## GET /v1/pools-feed/initial/state

Returns `LiquidityPoolInfo`: bonding-curve pool state, aggregated metrics (market cap, volume, locks, …), and token metadata.

### Query parameters

<ParamField query="asset" type="string" required>
  Cardano asset id: `{policyId}.{hexAssetName}`.
</ParamField>

## Response fields (summary)

<ResponseField name="pool" type="object">
  On-chain pool state: reserves `x` / `y`, curve parameters, output reference, graduation fields, etc.
</ResponseField>

<ResponseField name="metrics" type="object">
  `marketCap`, `totalVolumeAda`, `totalTxCount`, `crowned`, `sequentialOrderingEnabled`, `locks[]`, …
</ResponseField>

<ResponseField name="info" type="object">
  Ticker, description, logo CID, socials, launch type, creator keys, `assetType`, …
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -sS "https://analytics.snek.fun/v1/pools-feed/initial/state?asset=fbd4d3c334063ac19566f6ba39b6ec707ea91fa81d0c09201575c10b.44415645"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "pool": { "id": "…", "x": { "asset": ".", "amount": "4047902001" }, "y": { "asset": "…", "amount": "581952643" } },
    "metrics": { "marketCap": 23958227426, "totalVolumeAda": 143107165299, "totalTxCount": 573 },
    "info": { "asset": "…", "ticker": "DAVE", "description": "…" }
  }
  ```
</ResponseExample>

***

## GET /v1/pools-feed/curve/progress

Returns bonding curve completion as a percentage string.

### Response

```json theme={null}
{ "percent": "75.5" }
```

```bash theme={null}
curl -sS "https://analytics.snek.fun/v1/pools-feed/curve/progress?asset=fbd4d3c334063ac19566f6ba39b6ec707ea91fa81d0c09201575c10b.44415645"
```