Skip to main content
GET
Transactions

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

ticker_symbol
string

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

Example:

"AAPL,INTC"

min_value
string

Minimum transaction value in dollars

max_value
string

Maximum transaction value in dollars

min_price
string

Minimum stock price at the time of transaction

max_price
string

Maximum stock price at the time of transaction

owner_name
string

Name of the insider who made the transaction

sectors[]
enum<string>[]

Filter by company sector(s) An array of 1 or more sectors.

A singular sector.

Available options:
Basic Materials,
Communication Services,
Consumer Cyclical,
Consumer Defensive,
Energy,
Financial Services,
Healthcare,
Industrials,
Real Estate,
Technology,
Utilities
Example:
industries[]
string[]

Filter by company industry or industries An array of one or more industries.

Example:
min_marketcap
number

The minimum marketcap. Min: 0.

Required range: x >= 0
Example:

1000000

max_marketcap
number

The maximum marketcap. Min: 0.

Required range: x >= 0
Example:

250000000

market_cap_size
enum<string>

Size category of company market cap A market capitalization size category.

Available options:
micro,
small,
mid,
large,
big
Example:

"large"

min_earnings_dte
integer

The minimum days until the next earnings report.

Example:

5

max_earnings_dte
integer

The maximum days until the next earnings report.

Example:

30

min_amount
string

Minimum number of shares in transaction

max_amount
string

Maximum number of shares in transaction

is_director
boolean

Filter transactions by company directors

is_officer
boolean

Filter transactions by company officers

is_s_p_500
boolean

Only include S&P 500 companies

is_ten_percent_owner
boolean

Filter transactions by 10% owners

common_stock_only
boolean

Only include common stock transactions

transaction_codes[]
string

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

form_types[]
string

Filter by SEC form: 3, 3/A, 4, 4/A, 5, 5/A, 144, 144/A. Form 144 is a notice of intended sale, so pass 4 (and 4/A for amendments) to get executed trades only. Default: all forms.

reporter_cik
string

Exact match on the reporting owner's SEC CIK. The stable identifier for one insider across companies and years; owner_name spelling varies between filings.

security_ad_codes[]
string

Filter by security acquisition/disposition codes: NA, ND, DA, DD, D

limit
integer
default:500

How many items to return. Max: 500. Min: 1. Returns up to 500 when omitted.

Required range: 1 <= x <= 500
Example:

10

page
integer

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

Example:

1

cursor
string

The cursor.next value from the previous response. Returns the rows that follow it and ignores page.

group
boolean

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

start_date
string<date>

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

end_date
string<date>

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

Response

An aggregated insider trade

accession_no
string

SEC EDGAR accession number of the filing this row came from.

Example:

"0001127602-24-012345"

amended_original_accession_no
string | null

For /A amendments, the accession number of the filing being amended; null otherwise.

Example:

"0001127602-24-011111"

amount
integer

The amount of the insider trade.

Example:

1000

cursor
Pagination Cursor · object

Where the next page starts. Pass next as the cursor parameter to fetch it.

date_excercisable
string

The date excercisable of the insider trade.

Example:

"2023-12-06T00:00:00.000Z"

director_indirect
string

The director indirect of the insider trade.

Example:

"John Doe"

expiration_date
string

The expiration date of the insider trade.

Example:

"2023-12-06T00:00:00.000Z"

filing_date
string

The filing date of the insider trade.

Example:

"2023-12-06T00:00:00.000Z"

formtype
enum<string>

The SEC form the row came from: 3 (initial ownership), 4 (change in ownership), 5 (annual), 144 (notice of intended sale, not an executed trade), each with an /A variant for amendments.

Available options:
3,
3/A,
4,
4/A,
5,
5/A,
144,
144/A
Example:

"4"

has_more
boolean

Indicates whether there are more results available beyond the current page.

Example:

false

ids
string[]

The IDs of the insider trade.

Example:
is_10b5_1
boolean

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

Example:

true

is_director
boolean

Whether the insider is a director.

Example:

true

is_officer
boolean

Whether the insider is an officer.

Example:

true

is_ten_percent_owner
boolean

Whether the insider is a 10% owner.

Example:

true

issuer_cik
string

SEC Central Index Key of the issuing company.

Example:

"0001326801"

natureofownership
string

The nature of ownership of the insider trade.

Example:

"Direct"

officer_title
string

The officer title of the insider trade.

Example:

"CEO"

owner_name
string

The owner name of the insider trade.

Example:

"John Doe"

price
string

The price of the insider trade.

Example:

"123.45"

price_excercisable
string

The price excercisable of the insider trade.

Example:

"123.45"

reporter_cik
string

SEC Central Index Key of the reporting owner. Stable across issuers and over time, so use it rather than owner_name to tie one insider's filings together.

Example:

"0001548760"

security_ad_code
string

The security AD code of the insider trade.

Example:

"1234"

security_title
string

The security title of the insider trade.

Example:

"Common Stock"

shares_owned_after
integer

The number of shares owned after the insider trade.

Example:

2000

shares_owned_before
integer

The number of shares owned before the insider trade.

Example:

1000

ticker
string

The stock ticker.

Example:

"AAPL"

transaction_code
string

The transaction code of the insider trade.

Example:

"S"

transaction_date
string

The transaction date of the insider trade.

Example:

"2023-12-06T00:00:00.000Z"

transactions
integer

The number of transactions of the insider trade.

Example:

1