Public whale feed
curl --request GET \
--url https://api.probsights.com/v1/whales/public/feed \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.probsights.com/v1/whales/public/feed"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.probsights.com/v1/whales/public/feed', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"trades": [
{}
],
"stats": {},
"pagination": {},
"preview_only": true,
"unlocked_events": 123
}Whales
Public whale feed
Preview large trades from a rotating event pool without a watchlist.
GET
/
v1
/
whales
/
public
/
feed
Public whale feed
curl --request GET \
--url https://api.probsights.com/v1/whales/public/feed \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.probsights.com/v1/whales/public/feed"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.probsights.com/v1/whales/public/feed', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"trades": [
{}
],
"stats": {},
"pagination": {},
"preview_only": true,
"unlocked_events": 123
}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 for personal watchlists and
full per-event stats.
Request
https://api.probsights.com/v1/whales/public/feed
Query parameters
integer
default:"50"
1–500.
integer
default:"0"
Pagination offset.
string
ISO timestamp lower bound on trade time.
string
ISO timestamp upper bound on trade time.
string
kalshi or polymarket.number
Minimum notional in USD (
abs(price × size)). Defaults to the platform minimum.Response
array
Whale trade objects (same shape as the user feed).
object
Aggregate 24h stats for the unlocked event set (
total_volume_24h,
total_trades_24h, avg_trade_size).object
limit, offset, and total for the trade list.boolean
true when the caller is free-tier or unauthenticated — only a prefix of the
public pool is unlocked.integer
How many events in the daily pool are fully visible for this caller.
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)
curl "https://api.probsights.com/v1/whales/public/feed?limit=25&platform=kalshi"
import requests
response = requests.get(
"https://api.probsights.com/v1/whales/public/feed",
params={"limit": 25, "platform": "kalshi"},
)
feed = response.json()
Public events
curl "https://api.probsights.com/v1/whales/public/events?platform=polymarket"