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

# Public whale feed

> Preview large trades from a rotating event pool without a watchlist.

Browse whale trades from a daily-rotated pool of subscribed events. No API key is
required, but free and anonymous callers only see trades for a **preview subset** of
that pool.

Paid API keys unlock the full public pool on both `/v1/whales/public/feed` and
`/v1/whales/public/events`.

See [Whale tracking](/api-reference/whales-overview) for personal watchlists and
full per-event stats.

## Request

```
https://api.probsights.com/v1/whales/public/feed
```

### Query parameters

<ParamField query="limit" type="integer" default="50">
  1–500.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Pagination offset.
</ParamField>

<ParamField query="start_date" type="string">
  ISO timestamp lower bound on trade time.
</ParamField>

<ParamField query="end_date" type="string">
  ISO timestamp upper bound on trade time.
</ParamField>

<ParamField query="platform" type="string">
  `kalshi` or `polymarket`.
</ParamField>

<ParamField query="min_trade_size" type="number">
  Minimum notional in USD (`abs(price × size)`). Defaults to the platform minimum.
</ParamField>

## Response

<ResponseField name="trades" type="array">
  Whale trade objects (same shape as the user feed).
</ResponseField>

<ResponseField name="stats" type="object">
  Aggregate 24h stats for the unlocked event set (`total_volume_24h`,
  `total_trades_24h`, `avg_trade_size`).
</ResponseField>

<ResponseField name="pagination" type="object">
  `limit`, `offset`, and `total` for the trade list.
</ResponseField>

<ResponseField name="preview_only" type="boolean">
  `true` when the caller is free-tier or unauthenticated — only a prefix of the
  public pool is unlocked.
</ResponseField>

<ResponseField name="unlocked_events" type="integer">
  How many events in the daily pool are fully visible for this caller.
</ResponseField>

## Public event catalog

`GET /v1/whales/public/events` returns the same daily pool with per-event stats.
Events beyond the unlocked prefix include `locked: true`.

| Parameter  | Description                              |
| ---------- | ---------------------------------------- |
| `platform` | Optional `kalshi` or `polymarket` filter |

## Examples

### Public feed (no API key)

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.probsights.com/v1/whales/public/feed?limit=25&platform=kalshi"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.probsights.com/v1/whales/public/feed",
      params={"limit": 25, "platform": "kalshi"},
  )
  feed = response.json()
  ```
</CodeGroup>

### Public events

```bash theme={null}
curl "https://api.probsights.com/v1/whales/public/events?platform=polymarket"
```