Skip to main content
POST
Add event
Adds an event to your “My Events” watchlist. The 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

The numeric 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 to POST /whales/user/events/by-url with the same optional fields. We parse the event out of the URL.

Errors