Skip to main content
GET
/
api
/
v1
/
whale-trades
/
history
cURL
curl -sS \
  -H 'Authorization: Bearer $OXI_SK' \
  'https://api.0xinsider.com/api/v1/whale-trades/history'
{
  "object": "list",
  "data": [],
  "has_more": false,
  "next_cursor": null,
  "total": 0,
  "meta": {
    "request_id": "req_example",
    "cached": false
  }
}
Bounded historical whale-trade ranges. Built for backtests, recap reports, and warming a cache after a deploy. For the live feed, use Get Whale Trades. 
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/whale-trades/history?from=2026-04-01T00:00:00Z&to=2026-04-30T23:59:59Z&min_grade=A&limit=100"
Responses carry trust metadata, so you can tell provider-backed from reconciled or partial ranges. See Trust metadata.

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

​
min_grade
enum<string>

Minimum trader grade.

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

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

Available options:
polymarket,
kalshi,
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.

Response

Historical whale trade replay

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