Skip to main content
GET
/
v1
/
api
/
trades
/
whales
Whale trades
curl --request GET \
  --url https://api.dotprediction.io/v1/api/trades/whales \
  --header 'X-API-Key: <api-key>'
{
  "trades": [
    {
      "trade_id": "<string>",
      "market_id": "<string>",
      "platform": "<string>",
      "market_title": "<string>",
      "side": "<string>",
      "outcome": "<string>",
      "price": 123,
      "size": 123,
      "notional_value": 123,
      "timestamp": 123,
      "transaction_hash": "<string>",
      "trader": {
        "address": "<string>",
        "name": "<string>",
        "pseudonym": "<string>",
        "profile_image": "<string>"
      }
    }
  ],
  "pagination": {
    "total": 123,
    "limit": 123,
    "has_more": true,
    "next_cursor": "<string>"
  },
  "meta": {
    "platform": "<string>",
    "request_time": 123,
    "min_size_applied": 123,
    "sort": "<string>",
    "data_freshness": "<string>"
  }
}

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