Whale tracking
curl --request GET \
--url https://api.probsights.com/v1/whales/user/feed \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.probsights.com/v1/whales/user/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/user/feed', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Whales
Whale tracking
Personal watchlist, feed, stats, and market-level whale endpoints.
GET
/
v1
/
whales
/
user
/
feed
Whale tracking
curl --request GET \
--url https://api.probsights.com/v1/whales/user/feed \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.probsights.com/v1/whales/user/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/user/feed', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Monitor large trades on events you track. A whale trade is any stored trade whose
notional (
Each trade includes
abs(price × size)) meets the threshold on a tracked event.
Requires trade ingestion to have populated local trade storage. All routes in this
section require an API key — see Authentication.
For a no-key preview of community-subscribed events, use the
Public whale feed.
The playground below targets the user feed. Other routes are listed in the
examples.
Request
https://api.probsights.com/v1/whales/user/feed
Query parameters
Response
The user feed returns a wrapped object:| Field | Description |
|---|---|
trades | Array of whale trade objects |
stats | 24h aggregate stats for your watchlist |
pagination | limit, offset, total |
preview_only | Always false on the user feed |
unlocked_events | Always 0 on the user feed |
platform, event_ticker, market_id, outcome,
timestamp, trade_size_usd, price, and count.
Endpoint reference
| Method | Path | Description |
|---|---|---|
GET | /v1/whales/user/events | List tracked events |
POST | /v1/whales/user/events/by-ticker | Add by exchange + event ticker |
POST | /v1/whales/user/events/by-url | Add by Kalshi or Polymarket URL |
PATCH | /v1/whales/user/events/{event_id} | Update threshold or email alerts |
DELETE | /v1/whales/user/events/{event_id} | Remove by watchlist id |
DELETE | /v1/whales/user/events/by-ticker | Remove by exchange + event_ticker |
GET | /v1/whales/user/feed | Feed across your watchlist |
GET | /v1/whales/user/stats | Stats across your watchlist (period: 24h, 7d, all) |
GET | /v1/whales/event/{event_id}/trades | Trades for one tracked event |
GET | /v1/whales/event/{event_id}/stats | Stats for one tracked event |
GET | /v1/whales/markets | Markets with whale activity on your watchlist |
GET | /v1/whales/market/{market_id}/stats | Stats for one market |
GET | /v1/whales/market/{market_id}/trades | Trades for one market |
event_id in /v1/whales/event/{event_id}/… is your watchlist id (not the
exchange event ticker).
Examples
Whale feed
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.probsights.com/v1/whales/user/feed?limit=50&min_trade_size=1000"
import requests
response = requests.get(
"https://api.probsights.com/v1/whales/user/feed",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"limit": 50, "min_trade_size": 1000},
)
feed = response.json()
Watchlist
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.probsights.com/v1/whales/user/events"
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/v1/whales/user/events/by-ticker"
curl -X POST -H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://kalshi.com/markets/kxbtc/bitcoin-price","whale_threshold_usd":1000}' \
"https://api.probsights.com/v1/whales/user/events/by-url"
curl -X PATCH -H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"whale_threshold_usd":2500,"notify_on_whale_trade":true}' \
"https://api.probsights.com/v1/whales/user/events/1"
curl -X DELETE -H "X-API-Key: YOUR_API_KEY" \
"https://api.probsights.com/v1/whales/user/events/1"
Stats and per-event trades
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.probsights.com/v1/whales/user/stats?period=24h"
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.probsights.com/v1/whales/event/1/trades?limit=25"
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.probsights.com/v1/whales/market/KXBTC15M-26MAY020000-00/stats?period=all"
period accepts 24h, 7d, or all on stats endpoints.