Skip to main content
GET
cURL
Returns the ranked list of upcoming pre-game sports markets (moneyline and props) where graded smart money is piled on one side. Each signal carries the piled side and its CLOB token, the grade distribution of the pile (S/A/B holder counts), dollar concentration, the market’s kickoff time, and a grade-weighted conviction score — everything needed to act on the signal in one call, computed server-side. Ranking is grade-distribution driven: conviction_score = (5·s_count + 4·a_count + 3·b_count) · sharp_pct, so a market with more top-grade (S/A) traders concentrated on the piled side ranks higher. All raw fields are returned so callers can re-rank. Markets with no clear pile (roughly 50/50) are excluded.

Authorizations

Authorization
string
header
required

API key authentication. Send your key in the Authorization header as Bearer oxi_sk_live_.... Live keys require an active Insider subscription and return live data.

Headers

If-None-Match
string

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

Query Parameters

category
string

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.

limit
integer
default:20

Page size.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from a previous response's next_cursor. Encodes the snapshot anchor plus the last row's directional_rank_score, conviction_score, smart_score and condition_id. A cursor from an expired snapshot returns 400.

horizon_hours
integer
default:12

Kickoff ceiling in hours from now; the floor is now (only games not yet started). Clamped to 1..48.

Required range: 1 <= x <= 48
min_grade
enum<string>
default:B

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.

Available options:
S,
A,
B

Response

Ranked pre-game sports-edge signals

object
string
required
Allowed value: "list"
data
object[]
required
has_more
boolean
required
meta
object
required
next_cursor
string | null
total
integer | null