Transactions

GET https://api.unusualwhales.com/api/insider/transactions

Request

Security: Bearer Auth Authorization: Bearer <token>

Query Parameters

ticker_symbol Ticker optional

A comma separated list of tickers. To exclude certain tickers prefix the first ticker with a `-`.

Example: AAPL,INTC

min_value string optional

Minimum transaction value in dollars

max_value string optional

Maximum transaction value in dollars

min_price string optional

Minimum stock price at the time of transaction

max_price string optional

Maximum stock price at the time of transaction

owner_name string optional

Name of the insider who made the transaction

sectors[] Sectors optional

Filter by company sector(s)

Example: Consumer CyclicalTechnologyUtilities

enum: Basic Materials, Communication Services, Consumer Cyclical, Consumer Defensive, Energy, Financial Services, Healthcare, Industrials, Real Estate, Technology, Utilities

industries[] Industries optional

Filter by company industry or industries

Example: SemiconductorsSoftware - Infrastructure

min_marketcap Min Marketcap optional

The minimum marketcap. Min: 0.

Example: 1000000

>= 0

max_marketcap Max Marketcap optional

The maximum marketcap. Min: 0.

Example: 250000000

>= 0

market_cap_size Single market cap size optional

Size category of company market cap

Example: large

enum: micro, small, mid, large, big

min_earnings_dte Min Earnings DTE optional

The minimum days until the next earnings report.

Example: 5

max_earnings_dte Max Earnings DTE optional

The maximum days until the next earnings report.

Example: 30

min_amount string optional

Minimum number of shares in transaction

max_amount string optional

Maximum number of shares in transaction

is_director boolean optional

Filter transactions by company directors

is_officer boolean optional

Filter transactions by company officers

is_s_p_500 boolean optional

Only include S&P 500 companies

is_ten_percent_owner boolean optional

Filter transactions by 10% owners

common_stock_only boolean optional

Only include common stock transactions

transaction_codes[] string optional

Filter by transaction codes (P=Purchase, S=Sale, etc.)

security_ad_codes string optional

Filter by security acquisition disposition codes

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

page Page optional

Page number (use with limit). Starts on page 0.

Example: 1

group boolean optional

Group insider transactions with same person and trade code on the same day into a single row

start_date string optional

Filter for transaction dates occurring on or after this date (ISO format: YYYY-MM-DD)

end_date string optional

Filter for transaction dates occurring on or before this date (ISO format: YYYY-MM-DD)

Responses

200

Response Body 200 OK

amount Insider Amount

The amount of the insider trade.

Example: 1000

date_excercisable Insider Date Excercisable

The date excercisable of the insider trade.

Example: 2023-12-06

director_indirect Insider Director Indirect

The director indirect of the insider trade.

Example: John Doe

expiration_date Insider Expiration Date

The expiration date of the insider trade.

Example: 2023-12-06

filing_date Insider Filing Date

The filing date of the insider trade.

Example: 2023-12-06

formtype Insider Form Type

The form type of the insider trade.

Example: 4

ids Insider IDs

The IDs of the insider trade.

Example: ["1234"]

is_10b5_1 Insider Is 10b5-1

True if this insider trade was part of a 10b5-1 plan

Example: true

is_director Insider Is Director

Whether the insider is a director.

Example: true

is_officer Insider Is Officer

Whether the insider is an officer.

Example: true

is_ten_percent_owner Insider Is 10 Owner

Whether the insider is a 10% owner.

Example: true

natureofownership Insider Nature of Ownership

The nature of ownership of the insider trade.

Example: Direct

officer_title Insider Officer Title

The officer title of the insider trade.

Example: CEO

owner_name Insider Owner Name

The owner name of the insider trade.

Example: John Doe

price Insider Price

The price of the insider trade.

Example: 123.45

price_excercisable Insider Price Excercisable

The price excercisable of the insider trade.

Example: 123.45

security_ad_code Insider Security AD Code

The security AD code of the insider trade.

Example: 1234

security_title Insider Security Title

The security title of the insider trade.

Example: Common Stock

shares_owned_after Insider Shares Owned After

The number of shares owned after the insider trade.

Example: 2000

shares_owned_before Insider Shares Owned Before

The number of shares owned before the insider trade.

Example: 1000

ticker Stock Ticker

The stock ticker.

Example: AAPL

transaction_code Insider Transaction Code

The transaction code of the insider trade.

Example: S

transaction_date Insider Transaction Date

The transaction date of the insider trade.

Example: 2023-12-06

transactions Insider Transactions

The number of transactions of the insider trade.

Example: 1

Try It GET

API Token

Query Parameters

ticker_symbol Ticker

min_value string

max_value string

min_price string

max_price string

owner_name string

sectors[] Sectors

industries[] Industries

min_marketcap Min Marketcap

max_marketcap Max Marketcap

market_cap_size Single market cap size

min_earnings_dte Min Earnings DTE

max_earnings_dte Max Earnings DTE

min_amount string

max_amount string

is_director boolean

is_officer boolean

is_s_p_500 boolean

is_ten_percent_owner boolean

common_stock_only boolean

transaction_codes[] string

security_ad_codes string

limit Default 500 Max 500 Min 1

page Page

group boolean

start_date string

end_date string

Request Sample

curl -X GET "https://api.unusualwhales.com/api/insider/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/insider/transactions", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "data": [
    {
      "amount": -35921,
      "date_excercisable": null,
      "director_indirect": null,
      "expiration_date": null,
      "filing_date": "2024-12-12",
      "formtype": "144",
      "id": "2662b73d-0ad6-4568-adb0-739b96c18090",
      "ids": [
        "26f2911d-8e40-4fd4-9b74-c450e203a0ad"
      ],
      "is_10b5_1": true,
      "is_director": true,
      "is_officer": true,
      "is_s_p_500": true,
      "is_ten_percent_owner": true,
      "marketcap": "1375122749418",
      "natureofownership": null,
      "next_earnings_date": "2025-02-06",
      "officer_title": "COB and CEO",
      "owner_name": "ZUCKERBERG MARK",
      "price": "632",
      "price_excercisable": null,
      "sector": "Communication Services",
      "security_ad_code": null,
      "security_title": null,
      "shares_owned_after": null,
      "shares_owned_before": null,
      "stock_price": null,
      "ticker": "META",
      "transaction_code": "S",
      "transaction_date": "2024-12-12",
      "transactions": 1
    }
  ]
}