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

# Whale tracking

> Monitor large trades across prediction markets.

Monitor large trades across Kalshi and Polymarket. A whale trade is any stored trade
whose notional (`abs(price × size)`) meets the threshold on a tracked event.

The playground below targets the **user feed**. Watchlist and stats routes are listed
in the examples.

## Request

```
https://api.probsights.com/whales/user/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="event_id" type="string">
  Watchlist event id.
</ParamField>

<ParamField query="min_trade_size" type="number">
  Override the event threshold for the request.
</ParamField>

## Examples

### Whale feed

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "X-API-Key: YOUR_API_KEY" \
    "https://api.probsights.com/whales/user/feed?limit=50&min_trade_size=1000"
  ```

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

  response = requests.get(
      "https://api.probsights.com/whales/user/feed",
      headers={"X-API-Key": "YOUR_API_KEY"},
      params={"limit": 50, "min_trade_size": 1000},
  )
  feed = response.json()
  ```
</CodeGroup>

### Watchlist

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "X-API-Key: YOUR_API_KEY" \
    "https://api.probsights.com/whales/user/events"
  ```

  ```bash cURL (add) theme={null}
  curl -X POST -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"exchange":"kalshi","event_ticker":"KXBTC","whale_threshold_usd":1000}' \
    "https://api.probsights.com/whales/user/events/by-ticker"
  ```
</CodeGroup>

### Stats

```bash theme={null}
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.probsights.com/whales/user/stats?period=24h"
```

`period` accepts `24h`, `7d`, or `all`.