Unusual Whales UnusualWhales API

Unusual Trades by Ticker

GET https://api.unusualwhales.com/api/congress/unusual-trades/by-tickers

Request

Security: Bearer Auth Authorization: Bearer <token>

Query Parameters

tickers string optional

Comma-separated list of tickers to filter by.

transaction_type string optional

Filter to either buy- or sell-side transactions.

enum: buy, sell
date_from string optional

Inclusive lower bound on transaction_date (ISO 8601).

date_to string optional

Inclusive upper bound on transaction_date (ISO 8601).

politician string optional

Case-insensitive substring match against the politician's full name.

limit integer optional
Default: 100
>= 1 <= 500
page integer optional
Default: 1
>= 1

Responses

200 422 500

Response Body 200 OK

amount string

The disclosed amount range as a string.

Example: $1,001 - $15,000
asset string

Asset description as disclosed.

Example: NVIDIA Corp - Common Stock
asset_type string

The asset type.

Example: stock
company_name string

The full company name behind the traded ticker.

Example: NVIDIA Corp
description string

Additional disclosure description, if any.

filing_date string

The date the trade was disclosed.

Example: 2025-10-04
id string

The trade's unique ID.

Example: 5fbe81ac-1157-4bc8-9d76-c77e6164fe25
politician_id string

The politician's ID.

Example: e138f347-ae92-4cfb-8f41-7036ff09a213
politician_name string

The politician's full name.

Example: Nancy Pelosi
ticker string

The traded ticker symbol.

Example: NVDA
transaction_date string

The date the transaction occurred.

Example: 2025-09-12
transaction_type string

The type of transaction (e.g., Buy, Sell, Sale Partial).

Example: Buy
unusual_activity_meta array[object]

Per-tag metadata explaining why each flag was applied.

unusual_activity_tags array[string]

Reason tags this trade was flagged as unusual.

Example: ["committee_conflict"]
Try It GET
Query Parameters

Request Sample
curl -X GET "https://api.unusualwhales.com/api/congress/unusual-trades/by-tickers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response Example 200
{
  "data": [
    {
      "amount": "$1,001 - $15,000",
      "asset": "NVIDIA Corp - Common Stock",
      "asset_type": "stock",
      "company_name": "NVIDIA Corp",
      "description": "string"
    }
  ]
}