Skip to main content
GET
Use Large trades at /api/v1/large-trades in new clients. This older route remains available for existing integrations. Responses include Deprecation and Link headers that identify the replacement route.

​
Parameters

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

​
Key response fields

The response data matches Large trades.

​
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).

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

​
limit
integer
default:20

Maximum number of recent 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.

​
min_size
number
default:5000

Minimum trade size in USD.

​
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.

​
min_grade
enum<string>

Minimum trader grade as of today (trader.grade). 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 rows with persisted suspicion_score >= 60. The filter is applied before SQL-backed limit + 1 pagination.

​
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
​
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 the last 30 days, because the share is computed for each request and an unbounded ranking cannot be served inside the documented latency budget. 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
​
since
string

Return only the trades recorded after this one. Pass the id of a large trade this API returned (wt_, or the bare integer). The answer keeps the list shape and newest-first order, and next_cursor pages within it. After means commit order: a trade recorded late with an earlier traded_at is still returned, and a trade whose write has not committed yet is returned on a later poll, never skipped. To poll, send the id of the first trade on the first page of your last answer that had trades, with If-None-Match set to the ETag you last received; when nothing new was recorded the answer is 304 with an empty body. A late trade can come back once, so deduplicate on id. Only with sort=recent. An id that names no trade, or one more than 10000 trades behind the newest, answers 400 with error.param since; request the list without since and continue from its first trade.

Response

List of whale trades

​
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; the key is absent when it does not.