Skip to main content
GET
cURL
Use Sharp money flows in new clients. This alias accepts the same filters and returns the same rows and ETag. It remains available for existing clients and adds Deprecation and Link headers identifying the replacement.

Parameters

The parameters are exactly those of Sharp money flows: timeframe, limit, cursor, category, platform, min_grade, and direction. The names, the values, and the defaults are all unchanged, and the spec below lists them in full.

Key response fields

The rows are exactly those of Sharp money flows. Each one carries a canonical sharp_money object and a smart_money copy of it, with identical fields and values.

Headers the alias adds

The canonical route sends none of these headers.

Migrate

  1. Replace /api/v1/markets/smart-money-flows with /api/v1/markets/sharp-money-flows.
  2. Read sharp_money instead of smart_money. Both routes return both objects, with identical fields and values.
  3. Keep every query parameter as it is. None of the names or values changed.
On the remote MCP server the pair is get_sharp_money_flows and the deprecated get_smart_money_flows.

When a cursor expires

A cursor stops working when your filters or the rows behind it change. Row changes include a wallet’s grade crossing your min_grade, a trade arriving late inside the window, or a market’s title or category changing. A ranking update that leaves those rows unchanged keeps the cursor valid. An expired cursor returns 400 with error.reason cursor_expired and error.param cursor. Discard the cursor and request the first page again. There is no Retry-After on this error, because waiting does not fix it.

Example

The -i flag prints the Deprecation and Link headers above the body.

What it does not return

  • Anything the canonical route does not. The rows are the same, with identical fields and values.
  • A Sunset date. None is planned.
  • A smart_money object that differs from sharp_money. It is a copy of it, on this route and on the canonical one.

Caching

Save the response’s ETag and send it in If-None-Match on your next request. If the response has not changed, the server returns 304 Not Modified with no body.

Authorizations

Authorization
string
header
required

Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).

Scopes

read

Read markets, traders, large trades, positions, reports, search, the event stream and every MCP tool

Headers

X-Query-Validation
enum<string>

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Available options:
strict
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. Out-of-range values are clamped to 1..100.

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

Opaque cursor from previous response's next_cursor. Encodes the first-page as_of timestamp, normalized effective filters, ranking and aggregate collection revisions, plus the last row's absolute net flow and condition_id. A changed filter or collection returns cursor_expired; request the first page again.

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. Sports and esports only (#27306): a category outside them returns 400 bad_request with param category and names the accepted buckets. The word sports, in any casing, matches every sport but Esports, the provider's catch-all Sports category (cycling, lacrosse) included: use esports for Esports alone, or omit category for both (#32657).

platform
enum<string>
default:all

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

Available options:
polymarket,
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
condition_id
string

Only this market's flow: an exact raw provider condition_id. Cannot be combined with event_slug (400). An unknown market returns an empty list.

event_slug
string

Only the markets of one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them, ranked as the unfiltered list ranks. Matched case-insensitively; cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug.

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
total
integer