Skip to main content
GET
/
api
/
v1
/
whale-trades
cURL
curl -sS \
  -H 'Authorization: Bearer $OXI_SK' \
  'https://api.0xinsider.com/api/v1/whale-trades'
{
  "object": "list",
  "data": [],
  "has_more": false,
  "next_cursor": null,
  "total": 0,
  "meta": {
    "request_id": "req_example",
    "cached": false
  }
}
Recent large trades, newest first, each with the trader’s grade and a signal score. Useful filters:
  • min_grade=A: only trades from S/A-grade traders (set B to widen).
  • category=crypto: restrict to a market category.
  • min_size=10000: floor on trade notional in USD.
Each item carries the trade’s side (buy/sell) in the response; there is no side request filter. 
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/whale-trades?min_grade=A&category=crypto&min_size=10000&limit=50"
Cursor-paginated by timestamp. For a fixed time range (backtests, recap reports), use Whale Trades History. To fetch one returned wt_... item again, use Get Whale Trade.

Authorizations

​
Authorization
string
header
required

API key: Authorization: Bearer oxi_sk_live_... for live data (requires an active Insider subscription), or oxi_sk_test_... for sandbox/test mode (free account, deterministic fixture data, no live rows). Both key classes use the same paths; the prefix selects live vs sandbox.

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

Available options:
S,
A,
B,
C,
D,
F

Response

List of whale trades

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