Crypto Whale Transactions

GET https://api.unusualwhales.com/api/crypto/whale-transactions

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

amount_formatted string

Example: 9999.00

blockchain string

Example: ethereum

from_address string

Example: 0x1234567890abcdef1234567890abcdef12345678

id integer

Example: 1

timestamp string

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

to_address string

Example: 0xabcdef1234567890abcdef1234567890abcdef12

token_name string

Example: Ethereum

token_symbol string

Example: ETH

transaction_hash string

Example: 0x5c8f1e2d3a4b5c6d7e8f90a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d

transaction_type string

Example: transfer

usd_value string

Example: 33330000.00

whale_score string

Example: 87.50

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/whale-transactions" \
  -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/whale-transactions", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "amount_formatted": "9999.00",
      "blockchain": "ethereum",
      "from_address": "0x1234567890abcdef1234567890abcdef12345678",
      "id": 1,
      "timestamp": "2026-07-29T12:34:56Z"
    }
  ]
}