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
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.integer
Tiger watchlist event id (internal id from your watchlist).
number
Override the event threshold for the request.
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.