Skip to main content
GET
/
insider-trades
Get insider trades
curl --request GET \
  --url https://api.financialdatasets.ai/insider-trades \
  --header 'X-API-KEY: <api-key>'
{
  "insider_trades": [
    {
      "ticker": "<string>",
      "issuer": "<string>",
      "name": "<string>",
      "title": "<string>",
      "is_board_director": true,
      "transaction_date": "2023-12-25",
      "transaction_shares": 123,
      "transaction_price_per_share": 123,
      "transaction_value": 123,
      "shares_owned_before_transaction": 123,
      "shares_owned_after_transaction": 123,
      "security_title": "<string>",
      "transaction_type": "<string>",
      "filing_date": "2023-12-25"
    }
  ]
}

​
Overview

The insider trades API lets you access the stock buys and sales of public company insiders like CEOs, CFOs, and Directors. In addition to the stock buys and sales, you can also access the current ownership stakes of insiders. This data is useful for understanding the sentiment of company insiders. For example, you can answer questions like:
  • How many shares of Nvidia does Jensen Huang own?
  • How many shares of Microsoft did Satya Nadella buy last quarter?
  • How many shares of Apple has Tim Cook sold over the past year?
To get started, please create an account and grab your API key at financialdatasets.ai. You will use the API key to authenticate your API requests.

​
Available Tickers

You can fetch a list of available tickers with a GET request to: https://api.financialdatasets.ai/insider-trades/tickers/

​
Available Insiders

You can fetch a list of available insider names for a given ticker with a GET request to: https://api.financialdatasets.ai/insider-trades/names/?ticker=AAPL

​
Getting Started

There are only 3 steps for making a successful API call:
  1. Add your API key to the header of the request as X-API-KEY.
  2. Add query params like ticker and limit to filter the data.
  3. Execute the API request.

​
Filtering the Data

You can filter the data by ticker, name, limit, and filing_date. Note: ticker is required required. By default, limit is 100, name is null, and filing_date is null. The name parameter is used to filter trades by a specific insider. You can get the list of available names for a ticker from the /names endpoint above. The limit parameter is used to specify the number of trades to return. The maximum value is 1000. The filing_date parameter is used to specify the date of the trades. For example, you can include filters like filing_date_lte=2024-09-30 and filing_date_gte=2024-01-01 to get trades between January 1, 2024 and September 30, 2024. The available filing_date operations are:
  • filing_date_lte
  • filing_date_lt
  • filing_date_gte
  • filing_date_gt
  • filing_date

​
Example

Insider Trades
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'NVDA'     # stock ticker
limit = 100         # number of trades to return

# create the URL
url = (
    f'https://api.financialdatasets.ai/insider-trades'
    f'?ticker={ticker}'
    f'&limit={limit}'
)

# make API request
response = requests.get(url, headers=headers)

# parse insider_trades from the response
insider_trades = response.json().get('insider_trades')

​
Example (with name)

Insider Trades
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'NVDA'                 # stock ticker
name = 'HUANG JEN HSUN'        # insider name

# create the URL
url = (
    f'https://api.financialdatasets.ai/insider-trades'
    f'?ticker={ticker}'
    f'&name={name}'
)

# make API request
response = requests.get(url, headers=headers)

# parse insider_trades from the response
insider_trades = response.json().get('insider_trades')

​
Example (with filing_date)

Insider Trades
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'NVDA'     
filing_date_lte = '2024-01-01' # end date
filing_date_gte = '2020-01-01' # start date

# create the URL
url = (
    f'https://api.financialdatasets.ai/insider-trades'
    f'?ticker={ticker}'
    f'&filing_date_lte={filing_date_lte}'
    f'&filing_date_gte={filing_date_gte}'
)

# make API request
response = requests.get(url, headers=headers)

# parse insider_trades from the response
insider_trades = response.json().get('insider_trades')

Authorizations

​
X-API-KEY
string
header
required

API key for authentication.

Query Parameters

​
ticker
string
required

The ticker symbol of the company.

​
limit
integer
default:10

The maximum number of transactions to return (default: 10).

​
filing_date
string<date>

Filter by exact filing date in YYYY-MM-DD format.

​
filing_date_gte
string<date>

Filter by filing date greater than or equal to this date (YYYY-MM-DD).

​
filing_date_lte
string<date>

Filter by filing date less than or equal to this date (YYYY-MM-DD).

​
filing_date_gt
string<date>

Filter by filing date greater than this date (YYYY-MM-DD).

​
filing_date_lt
string<date>

Filter by filing date less than this date (YYYY-MM-DD).

Response

Insider trades response

​
insider_trades
object[]