Skip to main content
GET
cURL
Use Large trades history at /api/v1/large-trades/history in new clients. This older route remains available for existing integrations. This alias is removed on February 1, 2027. Responses include Deprecation, Sunset: Mon, 01 Feb 2027 00:00:00 GMT and Link headers that identify the replacement route; from that date the route returns 410 with error.code endpoint_retired.

Parameters

The route accepts the same parameters as Large trades history. The OpenAPI section below lists them.

Key response fields

The response data matches Large trades history.

What it does not return

This route adds no data beyond the replacement endpoint. Follow its documentation for field meanings, errors, pagination, and any caching behavior.

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

If-None-Match
string

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

Query Parameters

limit
integer
default:20

Maximum number of historical large trades to return. Out-of-range values are clamped to 1..100.

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

Pagination cursor from previous response's next_cursor. Prefix: wth_. URL-encode when replaying as a query parameter.

min_size
number
default:5000

Minimum trade size in USD.

condition_id
string

Exact raw provider condition_id. Unknown markets return an empty list.

trader
string

Trader wallet address, timestamp-suffixed wallet alias, or username resolved against the traders table. Unknown traders return an empty list.

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 (#27430): 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).

min_grade
enum<string>

Minimum trader grade.

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

Minimum grade the trader held when the trade filled (trader.grade_at_trade). Only rows whose trader.grade_at_trade_status is graded can match, so a trade before 2026-09-19T23:00Z, or one made while the wallet's grade was changing, never does. The same basis as min_grade_at_trade on GET /api/v1/large-trades, GET /api/v1/stream and webhook trade_filters, so a history read and a stream with the same floor agree. Applies to both sorts and beside condition_id, event_slug, trader and from/to. Sending it with min_grade is 400. A means S or A, B means S, A or B.

Available options:
S,
A,
B,
C,
D,
F
suspicious_only
boolean
default:false

When true, return only the trades the unusual-activity check flagged. The filter is applied before SQL-backed limit + 1 pagination.

platform
enum<string>

Filter by whale_alerts.platform. all is equivalent to omitted.

Available options:
polymarket,
all
from
string<date-time>

Inclusive RFC3339 lower bound on whale_alerts.traded_at.

to
string<date-time>

Exclusive RFC3339 upper bound on whale_alerts.traded_at. Must be after from when both are present.

min_market_volume_share
number

Keep only trades whose market_volume_share is known and at least this. A fraction, not a percent: 0.01 is one percent of the market's traded volume. A trade whose share is unavailable is never returned by a non-zero value, because an unavailable share cannot be said to clear a floor.

Required range: 0 <= x <= 1
new_wallets
boolean
default:false

When true, keep only trades by wallets whose first recorded trade (trader.first_trade_at) is under 30 days old, the wallets the site's New wallets view shows. No older trade can be a new wallet's, so the window starts 30 days back: a from earlier than that is moved up to it.

sort
enum<string>
default:recent

Order of the returned page. recent is newest first and is the default. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, with a trade whose share is unavailable last. That ranking reads from, or the last 30 days when from is omitted, for the same reason. A cursor is bound to the order it was minted in, so a continuation cannot cross from one order into the other.

Available options:
recent,
market_volume_share
event_slug
string

Only the large trades in 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. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), and cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug.

Response

Historical whale trade replay

object
string
required
Allowed value: "list"
data
object[]
required
data_quality
object
required

Writer-backed age and coverage for this page; it is part of the representation and the ETag, while transport cache facts remain in meta.

has_more
boolean
required
meta
object
required
next_cursor
string
total
integer

Total matching rows when the read model exposes a count; absent (or null) when it does not.