Skip to main content
GET
Whale trades

Authorizations

X-API-Key
string
header
required

API key for authentication. Generate one via the dashboard or the /v1/api/auth/api-keys endpoint.

Query Parameters

provider
enum<string>
required

The prediction market platform to query.

Available options:
kalshi,
polymarket,
limitless
market_id
string
required

The market ID to query whale trades for.

min_size
number
default:1000

Minimum trade size (default 1000).

start_time
integer<int64>

Start time as Unix timestamp.

end_time
integer<int64>

End time as Unix timestamp.

sort
enum<string>
default:time

Sort order.

Available options:
time,
size
limit
integer
default:50

Max results to return (default 50, max 200).

Required range: x <= 200
cursor
string

Pagination cursor from a previous response.

Response

Whale trades for the specified market.

trades
object[]
pagination
object
meta
object