List ranked smart-money flows
Ranks markets by absolute net S/A/B-grade whale flow over a requested timeframe. Use this discovery endpoint to answer where smart money is flowing before drilling into a specific market with /api/v1/market/{condition_id}/intel. Pagination is anchored by an opaque cursor carrying the first page as_of timestamp so new whale trades do not reorder page 2.
Query parameters
Lookback window for grade-filtered whale flow aggregation.
Page size.
Opaque cursor from previous response's next_cursor. Encodes the first-page as_of timestamp plus the last row's absolute net flow and condition_id.
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.
Filter by source platform. all is a request-side no-op.
Minimum latest trader grade included in the flow. Default B means S/A/B only; unranked traders are excluded.
Optional post-aggregate flow direction filter.
Headers
Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.
Response
Ranked market smart-money flows