v25

OpenAPI 3.1.0raw.githubusercontent.com2026-08-015486519.4 KB

Whale Trades

List whale trades

Returns recent large trades with signal scoring. Filter by size, category, or trader grade. 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

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.

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.