List ranked pre-game sports-edge signals
Insider-tier. Ranked list of upcoming pre-game sports markets (moneyline + props) where graded (S/A/B) smart money is piled on one side, each row carrying the piled side, its grade distribution (S/A/B counts, dollar concentration, top grade), the kickoff time, and the piled-side Polymarket CLOB token id. Eligibility is a market with recent graded whale FLOW in the kickoff window; ranking is the current graded HOLDER pile. Deliberately NOT the editorial Pick of the Day ranker. Served from a shared server-side snapshot cache (TTL ~180s) computed once per category window at the maximum 48h horizon and filtered to the requested horizon_hours at request time (so every horizon shares one cache entry); the cursor pins to that snapshot and a stale cursor is rejected. Polymarket only (Kalshi lacks kickoff + graded-holder data).
Query parameters
Optional canonical sport bucket filter (e.g. Basketball, Tennis, Soccer). A raw provider value (NBA) resolves to its canonical bucket. A non-sport category returns an empty list.
Page size.
Opaque cursor from a previous response's next_cursor. Encodes the snapshot anchor plus the last row's conviction_score, smart_score and condition_id. A cursor from an expired snapshot returns 400.
Kickoff ceiling in hours from now; the floor is now (only games not yet started). Clamped to 1..48.
Minimum trader grade required on the piled side. Only S, A, B are accepted (the piled-side grade distribution is S/A/B only; C, D, F return 400). Default B means at least one S/A/B holder is piled; S requires an S holder, A requires an S or A holder.
Headers
Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.
Response
Ranked pre-game sports-edge signals