Skip to main content
GET
cURL
Canonical endpoint for discovering where S, A, and B grade whale flow is concentrated before you know a market’s condition_id. Filter by timeframe, category, platform, minimum grade, or direction. Results are ranked by absolute net flow. The opaque cursor preserves the first page’s as_of timestamp, so new trades do not reorder later pages.
GET /api/v1/markets/smart-money-flows remains available as a deprecated byte-identical alias. New integrations should use this canonical route.

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

timeframe
enum<string>
default:24h

Lookback window for grade-filtered whale flow aggregation.

Available options:
1h,
4h,
24h,
7d
limit
integer
default:20

Page size.

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

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.

category
string

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.

platform
enum<string>
default:all

Filter by source platform. all is a request-side no-op.

Available options:
polymarket,
kalshi,
all
min_grade
enum<string>
default:B

Minimum latest trader grade included in the flow. Default B means S/A/B only; unranked traders are excluded.

Available options:
S,
A,
B,
C,
D,
F
direction
enum<string>

Optional post-aggregate flow direction filter.

Available options:
YES,
NO

Response

Ranked market sharp-money flows

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