Recent Crypto Whale Trades

GET https://api.unusualwhales.com/api/crypto/whales/recent

Request

Security: Bearer Auth Authorization: Bearer <token>

Query Parameters

limit Default 500 Max 500 Min 1 optional

How many items to return. Default: 500. Max: 500. Min: 1.

Example: 10 Default: 500

>= 1 <= 500

Responses

200 422 500

Response Body 200 OK

exchange string

Example: Coinbase

id string

pair string

Example: BTC-USD

price string

Example: 93210.00

side string

Example: buy

size string

Example: 88.88

symbol string

Example: BTC

total string

Example: 8282828.00

whaled_at string

Example: 2026-07-29T12:34:56Z

Try It GET

API Token

Query Parameters

limit Default 500 Max 500 Min 1

Request Sample

curl -X GET "https://api.unusualwhales.com/api/crypto/whales/recent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/crypto/whales/recent", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "exchange": "Coinbase",
      "id": "string",
      "pair": "BTC-USD",
      "price": "93210.00",
      "side": "buy"
    }
  ]
}