Replay historical whale trades
Returns historical whale trades from local whale_alerts rows, not request-time provider fetches. Filter by condition_id, trader, category, minimum grade, platform, and RFC3339 from/to windows. All filters are pushed into SQL before LIMIT, every request uses SQL-backed limit + 1 pagination, and results are ordered newest first by traded_at desc, id desc. Metadata exposes local_replay source and best_effort completeness.
Query parameters
Pagination cursor from previous response's next_cursor. Prefix: wth_. URL-encode when replaying as a query parameter.
Minimum trade size in USD.
Exact raw provider condition_id. Unknown markets return an empty list.
Trader wallet address, timestamp-suffixed wallet alias, or username resolved against the traders table. Unknown traders return an empty list.
Filter by market category (case-insensitive). A canonical bucket name (e.g. Basketball) matches every provider member that folds into it (NBA, WNBA, NCAAB); a raw provider value also resolves to its bucket.
Minimum trader grade.
Filter by whale_alerts.platform. all is equivalent to omitted.
Inclusive RFC3339 lower bound on whale_alerts.traded_at.
Exclusive RFC3339 upper bound on whale_alerts.traded_at. Must be after from when both are present.
Headers
Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.
Response
Historical whale trade replay