Events

Replay public large-trade events

Returns durable public large-trade events strictly after an opaque cursor, in commit order: events are ordered by the position at which their write became visible to every reader (whale_alerts.inserted_xid), then by whale_alerts.id, and a page never reaches past the oldest write transaction still open when it was read. A trade whose id is lower than one already delivered but whose write finished later is therefore delivered on a later request instead of being skipped (#16180). This is a separate API-key contract from the browser/session /api/events/feed stream: browser-only and private alert, following, radar, and position patch events are excluded until they have a durable public outbox.

get/api/v1/events/feed/since

Query parameters

cursorstring

Opaque event replay cursor returned as next_cursor by a prior response. The cursor maps to the global (whale_alerts.inserted_xid, whale_alerts.id) commit-order position, is valid across backend replicas, and is bound to the filter set the walk ran with (trader, condition_id, min_grade, min_size): presenting it under different filters answers 400 bad_request with error.reason cursor_expired, and the walk restarts without a cursor. Cursors issued before 2026-09-22 (id-only) stay accepted and are bound to no filters. Omit to fetch the latest durable public suffix.

limitinteger

Maximum durable public whale-trade events to return.

traderstring

Only this wallet's trades: a wallet address, trd_-prefixed trader id or username resolved against the traders table. Bound to the cursor: a cursor issued under other filters answers 400 with error.reason cursor_expired. An unknown trader matches nothing and the walk still advances.

condition_idstring

Only trades on this market: the raw provider condition_id or its mkt_-prefixed id. Bound to the cursor.

min_grade'S' | 'A' | 'B' | 'C' | 'D' | 'F'

Only trades by wallets at this grade or better (S best), read from the wallet's newest ranking at request time; a wallet with no grade never passes. Bound to the cursor.

min_sizenumber

Only trades of at least this size in USD (compared in cents). Bound to the cursor.

expandstring[]

Repeatable. trade adds the public trade read to every event (the object GET /api/v1/whale-trades/{id} returns for it), from one query per page, so a page of 100 events needs no per-event detail request. Not bound to the cursor: switch it on or off mid-walk.

Headers

X-Query-Validation'strict'

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Response

Public event replay window

object'event_replay' required

has_moreboolean required

next_cursorstring required

Changes

Changed in 22 of the 89 revisions of this API.14245167

Sep 23, 2026ece7a25b7a4488See the full diff
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new freshness_ceiling_unsatisfied enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Sep 23, 2026a885dfbbeaff4See the full diff
- ○
  response property data/items/trade/oneOf[LargeTrade]/recorded_signal_score deprecated
  response-property-deprecated
- ○
  response property data/items/trade/oneOf[LargeTrade]/signal_score deprecated
  response-property-deprecated
- ○
  added the required property /////// to the response with the status
  response-required-property-added
- ○
  added the required property /////// to the response with the status
  response-required-property-added
Sep 23, 20268462acf80f8c181See the full diff
- ▲
  added to the // response property oneOf list for the response status
  response-property-one-of-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new export_expired enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  removed from the // response property oneOf list for the response status
  response-property-one-of-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 22, 202619386d595e054See the full diff
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  the response property /////// became required for the status
  response-property-became-required
- ○
  added the required property //////// to the response with the status
  response-required-property-added
- ○
  added the required property //////// to the response with the status
  response-required-property-added
Sep 22, 2026258f351891965See the full diff
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
Sep 22, 202645397ad42c948See the full diff
- ○
  added the new optional query request parameter condition_id
  new-optional-request-parameter
- ○
  added the new optional query request parameter expand
  new-optional-request-parameter
- ○
  added the new optional query request parameter min_grade
  new-optional-request-parameter
- ○
  added the new optional query request parameter min_size
  new-optional-request-parameter
- ○
  added the new optional query request parameter trader
  new-optional-request-parameter
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
Sep 22, 20261c5e270b412481See the full diff
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new unknown_query_parameter enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new optional header request parameter X-Query-Validation
  new-optional-request-parameter
Sep 22, 20269958c95371de16See the full diff
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_not_prepared enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_secret_rotation_overlap_active enum value to the / response property for the response status
  response-property-enum-value-added
Sep 22, 2026f279f722129f5See the full diff
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
Sep 22, 2026df3d184a44265See the full diff
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added
- ○
  added the required property /// to the response with the status
  response-required-property-added

Full history (22 revisions)