Add event
Whale tracking
Add event
Subscribe to an event so its whale trades appear in your feed and alerts.
POST
Add event
Adds an event to your “My Events” watchlist. The
The numeric
exchange and event_ticker map directly onto the exchange and event_id fields returned by Search events, so you can pipe a search result straight into a subscription.
If we have never seen the event before, we fetch its metadata from the exchange and start tracking it. Markets under the event are discovered automatically, so whale trades begin flowing into your feed shortly after.
Body parameters
string
required
kalshi or polymarket.string
required
The event identifier. This is the
event_id value from a Search events result: a Kalshi event ticker (for example KXBTCD-26JAN01) or a Polymarket event slug (for example btc-up-or-down-15m-1782248400).number
Minimum trade size, in USD, for a trade on this event to count as a whale. Defaults to your account default when omitted.
Example
Response
event_id is your internal tracking id. You can pass it to Update event, or unsubscribe with either the exchange/event_ticker pair or this numeric id (see Remove event).
Adding by URL
If you have a Kalshi or Polymarket page URL instead of a search result, post it toPOST /whales/user/events/by-url with the same optional fields. We parse the event out of the URL.