Insider

List insider transactions

Retrieve a paginated feed of SEC insider trading transactions from Forms 3, 4, and 5.

Data Source

This endpoint returns transactions reported by corporate insiders (officers, directors, and 10% owners) to the SEC. Each transaction represents a buy, sell, grant, gift, or other transfer of company securities.

Transaction Codes

The transactionCode field indicates the type of transaction:

CodeDescriptionCommon Usage
POpen market purchaseMost common buy signal
SOpen market saleMost common sell signal
AAward/grantStock compensation
MExercise of derivativeOptions/warrants exercise
GGiftTransfer to family/charity
FTax paymentShares sold for tax withholding
XExercise in-the-moneyOptions exercise

Filtering Tips

  • Use direction=buy to see only acquisitions (bullish signals)
  • Use direction=sell to see only dispositions
  • Use codes=P,S to see open market trades only (excludes awards, gifts)
  • Use derivative=false to see only equity transactions
  • Use minValue=100000 to see only large transactions

Understanding the Data

  • shares: Number of securities in the transaction
  • pricePerShare: Price per share (null for gifts, awards, etc.)
  • transactionValue: Computed total value (shares × price)
  • sharesAfter: Insider's total holdings after this transaction
  • directIndirect: D=Direct ownership, I=Indirect (through trust, etc.)
  • isDerivative: true=Options/warrants, false=Common stock

Example Use Cases

  1. Track CEO purchases: Filter by insiderCik + direction=buy
  2. Monitor large sales: Filter by direction=sell + minValue=1000000
  3. Company insider activity: Filter by ticker=AAPL
  4. Recent trades by all insiders: No filters, sorted by date
get/api/v1/insider/transactions

Request

  • Base URL: https://earningsfeed.com
  • URL: https://earningsfeed.com/api/v1/insider/transactions
  • Auth: HTTP bearer

Query parameters

limitinteger

Number of items to return (1-100)

Example:25
cursorstring

Cursor for pagination (opaque string from previous response)

Example:eyJzb3J0IjoiMjAyNC0xMS0wMVQxMjozMDowMC4wMDBaIiwiaWQiOjEyMzQ1fQ
cikinteger

Filter by company CIK (issuer)

Example:320193
tickerstring

Filter by company stock ticker

Example:AAPL
insiderCikinteger

Filter by insider CIK (reporting person)

Example:320193
string
OR
string[]
direction'buy' | 'sell' | 'all'

Filter by transaction direction:

  • buy = Acquisitions only (transaction codes P, A, M, X, etc. with acquiredDisposed=A)
  • sell = Dispositions only (transaction codes S, F, D, etc. with acquiredDisposed=D)
  • all = All transactions
Example:buy
derivative'true' | 'false' | 'all'

Filter by security type. 'true' for derivatives only, 'false' for equity only.

startDatestring

Filter transactions on or after this date (YYYY-MM-DD)

Example:2024-01-01
endDatestring

Filter transactions on or before this date (YYYY-MM-DD)

Example:2024-12-31
minValuenumber

Minimum transaction value (shares * price) in USD

Example:100000
maxValuenumber

Maximum transaction value in USD

Example:10000000
qstring

Search query for company name, insider name, or ticker

Example:Apple

Response

Paginated list of insider transactions

nextCursorstring nullable required

Cursor for next page, null if no more pages

hasMoreboolean required

Whether more items exist beyond this page

Example response

{
  "items": [
    {
      "accessionNumber": "0001234567-24-000123",
      "filedAt": "2024-10-30T00:00:00.000Z",
      "formType": "4",
      "personCik": 1234567,
      "personName": "John Doe",
      "companyCik": 320193,
      "companyName": "Apple Inc.",
      "ticker": "AAPL",
      "officerTitle": "Chief Executive Officer",
      "securityTitle": "Common Stock",
      "transactionDate": "2024-10-28",
      "transactionCode": "P",
      "shares": "10000.0000",
      "pricePerShare": "175.5000",
      "acquiredDisposed": "A",
      "sharesAfter": "150000.0000",
      "directIndirect": "D",
      "ownershipNature": "By Trust",
      "conversionOrExercisePrice": "100.0000",
      "exerciseDate": "2025-01-15",
      "expirationDate": "2030-01-15",
      "underlyingSecurityTitle": "Common Stock",
      "underlyingShares": "1000.0000",
      "transactionValue": 1755000
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.