Whale Trades

List whale trades

Returns recent large trades with signal scoring and persisted suspicion facts. Filter by size, category, trader grade, or persisted suspicion. Filters are applied before pagination, and every request uses SQL-backed limit + 1 pagination so has_more and next_cursor reflect the filtered result set. Cursor-paginated, newest first. Market categories come from provider-backed market_canonical identity.

get/api/v1/whale-trades

Query parameters

limitinteger

Maximum number of recent large trades to return.

cursorstring

Pagination cursor from previous response's next_cursor.

min_sizenumber

Minimum trade size in USD.

categorystring

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.

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

Minimum trader grade.

suspicious_onlyboolean

When true, return only rows with persisted suspicion_score >= 60. The filter is applied before SQL-backed limit + 1 pagination.

Headers

If-None-Matchstring

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Response

List of whale trades

object'list' required

has_moreboolean required

next_cursorstring nullable

totalinteger nullable

Total matching rows when the read model exposes a count; absent (or null) when it does not.

Changes

Changed in 10 of the 31 revisions of this API.84157

Aug 29, 20267c0c7cdd41ee7See the full diff
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new database_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
Aug 29, 20268582a359fa0719See the full diff
- ○
  added the new optional query request parameter suspicious_only
  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 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
- ○
  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 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
Aug 3, 2026918e082b045a1See the full diff
- ○
  added the required property // to the response with the status
  response-required-property-added
Jul 30, 202619193b1771541488See the full diff
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new idempotency_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new webhook_delivery_in_progress 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
- ○
  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
- ○
  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
- ○
  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
- ○
  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
- ○
  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
- ○
  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
- ○
  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
- ○
  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
- ○
  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
- ○
  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
Jul 14, 202622ab6cfbf30039See the full diff
- ○
  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
- ○
  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
- ○
  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
- ○
  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 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
- ○
  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
Jul 1, 2026e31231c630fb2See the full diff
- ○
  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
Jun 1, 2026422bd4dc1611633See the full diff
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new account_locked enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new bad_request enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new forbidden enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new internal_error enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid_api_key enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new not_found enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limit_unavailable enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new rate_limited enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ●
  added the new subscription_required enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  api operation id get_whale_trades removed and replaced with listWhaleTrades
  api-operation-id-removed
- ○
  added the new optional header request parameter If-None-Match
  new-optional-request-parameter
- ○
  added the non-success response with the status
  response-non-success-status-added
May 7, 20262907497f4ca32See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
Apr 3, 202624aa764c32ea2See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
Mar 25, 2026e658903dd89b1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history