Get insider sale notices
curl --request GET \
--url https://api.financialdatasets.ai/insider-trades/sale-notices \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.financialdatasets.ai/insider-trades/sale-notices"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.financialdatasets.ai/insider-trades/sale-notices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.financialdatasets.ai/insider-trades/sale-notices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.financialdatasets.ai/insider-trades/sale-notices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.financialdatasets.ai/insider-trades/sale-notices")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.financialdatasets.ai/insider-trades/sale-notices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"sale_notices": [
{
"ticker": "<string>",
"issuer": "<string>",
"name": "<string>",
"relationships": [
"<string>"
],
"form_type": "144",
"filing_date": "2023-12-25",
"notice_date": "2023-12-25",
"accession_number": "<string>",
"replaces_accession_number": "<string>",
"securities": [
{
"security_title": "<string>",
"shares_to_sell": 123,
"market_value": 123,
"shares_outstanding": 123,
"approximate_sale_date": "2023-12-25",
"exchange": "<string>",
"broker": "<string>"
}
],
"acquisitions": [
{
"security_title": "<string>",
"acquired_date": "2023-12-25",
"nature_of_acquisition": "<string>",
"acquired_from": "<string>",
"is_gift": true,
"donor_acquired_date": "2023-12-25",
"shares": 123,
"payment_date": "2023-12-25",
"nature_of_payment": "<string>"
}
],
"sales_past_3_months": [
{
"name": "<string>",
"security_title": "<string>",
"sale_date": "2023-12-25",
"shares": 123,
"gross_proceeds": 123
}
],
"plan_adoption_dates": [
"2023-12-25"
],
"remarks": "<string>",
"filing_url": "<string>"
}
],
"next_page_url": "<string>"
}{
"error": "Bad Request",
"message": "Invalid request parameters"
}{
"error": "Unauthorized",
"message": "Invalid API key provided"
}{
"error": "Payment Required",
"message": "This endpoint requires a paid subscription. Please upgrade your plan."
}Datasets
Insider Sale Notices API (SEC Form 144)
SEC Form 144 notices of proposed insider stock sales: 130,000+ notices, complete from April 2023, updated within minutes of each filing.
GET
/
insider-trades
/
sale-notices
Get insider sale notices
curl --request GET \
--url https://api.financialdatasets.ai/insider-trades/sale-notices \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.financialdatasets.ai/insider-trades/sale-notices"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.financialdatasets.ai/insider-trades/sale-notices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.financialdatasets.ai/insider-trades/sale-notices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.financialdatasets.ai/insider-trades/sale-notices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.financialdatasets.ai/insider-trades/sale-notices")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.financialdatasets.ai/insider-trades/sale-notices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"sale_notices": [
{
"ticker": "<string>",
"issuer": "<string>",
"name": "<string>",
"relationships": [
"<string>"
],
"form_type": "144",
"filing_date": "2023-12-25",
"notice_date": "2023-12-25",
"accession_number": "<string>",
"replaces_accession_number": "<string>",
"securities": [
{
"security_title": "<string>",
"shares_to_sell": 123,
"market_value": 123,
"shares_outstanding": 123,
"approximate_sale_date": "2023-12-25",
"exchange": "<string>",
"broker": "<string>"
}
],
"acquisitions": [
{
"security_title": "<string>",
"acquired_date": "2023-12-25",
"nature_of_acquisition": "<string>",
"acquired_from": "<string>",
"is_gift": true,
"donor_acquired_date": "2023-12-25",
"shares": 123,
"payment_date": "2023-12-25",
"nature_of_payment": "<string>"
}
],
"sales_past_3_months": [
{
"name": "<string>",
"security_title": "<string>",
"sale_date": "2023-12-25",
"shares": 123,
"gross_proceeds": 123
}
],
"plan_adoption_dates": [
"2023-12-25"
],
"remarks": "<string>",
"filing_url": "<string>"
}
],
"next_page_url": "<string>"
}{
"error": "Bad Request",
"message": "Invalid request parameters"
}{
"error": "Unauthorized",
"message": "Invalid API key provided"
}{
"error": "Payment Required",
"message": "This endpoint requires a paid subscription. Please upgrade your plan."
}Overview
The Financial Datasets insider sale notices API returns the notices that company insiders file with the SEC on Form 144 when they plan to sell stock. An officer, a director, or a large shareholder files a notice when they place an order to sell more than 5,000 shares or $50,000 of the company’s stock in three months. It holds 130,000+ notices, updated within minutes of each filing. Every notice is parsed directly from SEC EDGAR (data provenance). You can call it as a REST endpoint with an API key, or from Claude, ChatGPT, Cursor, and other AI apps through the MCP server, or pay per request with x402. Pricing starts at $20. A sale notice is early news of an insider sale. It is filed with the sell order, before the Form 4 that reports the completed trade. It complements the insider trades API: notices are the planned sales, trades are the completed buys and sells. With no filter, the endpoint is a feed of the newest notices from every company. Add filters to answer questions like:- Which insiders filed a notice to sell Apple stock this month?
- Which sale notices did one insider file this year, and under which trading plan?
- Which insiders across the market filed a notice to sell today?
Coverage
| Notices | History | Updated |
|---|---|---|
| 130,000+ | Complete from April 13, 2023 | Within minutes of each filing |
Getting Started
There are only 3 steps for making a successful API call:- Add your API key to the header of the request as
X-API-KEY. - Add query params like
tickerandlimitto filter the data. - Execute the API request.
The Response
Each item is one notice. Numbers and text are as the seller filed them. These fields need a word:ticker: the ticker you asked for. With notickerfilter, it is the company’s main ticker.nameandrelationships: the seller, and the seller’s relationship to the company (e.g.,Officer,Director), as filed.form_type:144for a notice,144/Afor a corrected notice.replaces_accession_number: on a corrected notice, the accession number of the notice it replaces. The API returns the newest version of a notice only.filing_dateandnotice_date: the day the SEC received the notice, and the day the seller signed it.securities: one entry per class of stock to sell, withshares_to_sell,market_value,shares_outstanding,approximate_sale_date,exchange, andbroker.acquisitions: how and when the seller got the shares, for example restricted stock units from the company.is_giftanddonor_acquired_datetell you about shares the seller received as a gift.sales_past_3_months: the seller’s sales of the company’s stock in the three months before the notice, withsale_date,shares, andgross_proceeds. Thenameon a sale can be a trust or another account of the seller. The list is empty when the seller reports no sales.plan_adoption_dates: the day the seller adopted the Rule 10b5-1 trading plan that the sale falls under. The list is empty when the notice names no plan.remarks: the seller’s free text. On a corrected notice it often says what changed.filing_url: the notice on SEC EDGAR.
What a Notice Tells You
- A planned sale, not a completed trade. The seller files the notice with the sell order, and the sale often happens the same day. The completed trade is in the insider trades API.
- The most the seller may sell. The actual sale can be smaller, or may not happen.
- Sales only. There is no notice for a purchase.
Filtering the Data
No parameter is required. With no filter, you get the newest notices first. You can filter the data byticker, name, and filing_date. All filters combine.
Note: by default, limit is 10.
The ticker parameter is used to filter the notices of one company (e.g., AAPL). It matches the company, so the share classes of one company give the same notices: GOOG and GOOGL both return every Alphabet notice.
The name parameter is used to filter notices by seller. Every word you send must be in the name, in any order and any case, so name=James Fay finds “Fay James Daniel”, and a last name alone is enough.
The filing_date parameter filters by the day the notice was filed, in YYYY-MM-DD format. For example, filing_date_gte=2026-01-01 and filing_date_lte=2026-06-30 give the notices filed in the first half of 2026.
The available filing_date operations are:
filing_date_ltefiling_date_ltfiling_date_gtefiling_date_gtfiling_date
limit parameter is the total number of notices to return across all pages. Each page holds up to 10 notices, linked by next_page_url. The maximum value is 1000.
Example (the feed)
Insider Sale Notices
import requests
# add your API key to the headers
headers = {
"X-API-KEY": "your_api_key_here"
}
# the newest notices from every company
url = 'https://api.financialdatasets.ai/insider-trades/sale-notices?limit=10'
# make API request
response = requests.get(url, headers=headers)
# parse sale_notices from the response
sale_notices = response.json().get('sale_notices')
Example (with ticker)
Insider Sale Notices
import requests
# add your API key to the headers
headers = {
"X-API-KEY": "your_api_key_here"
}
# set your query params
ticker = 'AAPL' # stock ticker
limit = 10 # number of notices to return
# create the URL
url = (
f'https://api.financialdatasets.ai/insider-trades/sale-notices'
f'?ticker={ticker}'
f'&limit={limit}'
)
# make API request
response = requests.get(url, headers=headers)
# parse sale_notices from the response
sale_notices = response.json().get('sale_notices')
Example (with name)
Insider Sale Notices
import requests
# add your API key to the headers
headers = {
"X-API-KEY": "your_api_key_here"
}
# set your query params
name = 'Parekh' # every word must be in the seller's name
# create the URL
url = (
f'https://api.financialdatasets.ai/insider-trades/sale-notices'
f'?name={name}'
f'&limit=10'
)
# make API request
response = requests.get(url, headers=headers)
# parse sale_notices from the response
sale_notices = response.json().get('sale_notices')
Example (with filing_date)
Insider Sale Notices
import requests
# add your API key to the headers
headers = {
"X-API-KEY": "your_api_key_here"
}
# set your query params
ticker = 'AAPL'
filing_date_gte = '2026-01-01' # start date
filing_date_lte = '2026-06-30' # end date
# create the URL
url = (
f'https://api.financialdatasets.ai/insider-trades/sale-notices'
f'?ticker={ticker}'
f'&filing_date_gte={filing_date_gte}'
f'&filing_date_lte={filing_date_lte}'
)
# make API request
response = requests.get(url, headers=headers)
# parse sale_notices from the response
sale_notices = response.json().get('sale_notices')
Example Response
{
"sale_notices": [
{
"ticker": "AAPL",
"issuer": "Apple Inc.",
"name": "KEVAN PAREKH",
"relationships": ["Officer"],
"form_type": "144",
"filing_date": "2026-10-16",
"notice_date": "2026-10-16",
"accession_number": "0001950047-26-010286",
"replaces_accession_number": null,
"securities": [
{
"security_title": "Common",
"shares_to_sell": 1392,
"market_value": 476064.0,
"shares_outstanding": 14594180000,
"approximate_sale_date": "2026-10-16",
"exchange": "NASDAQ",
"broker": "Morgan Stanley Smith Barney LLC Executive Financial Services"
}
],
"acquisitions": [
{
"security_title": "Common",
"acquired_date": "2026-10-15",
"nature_of_acquisition": "Restricted Stock Units",
"acquired_from": "Issuer",
"is_gift": false,
"donor_acquired_date": null,
"shares": 1392,
"payment_date": "2026-10-15",
"nature_of_payment": "N/A"
}
],
"sales_past_3_months": [],
"plan_adoption_dates": ["2025-11-21"],
"remarks": null,
"filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000195004726010286/primary_doc.xml"
}
]
}
FAQ
Where does the sale notice data come from?
Directly from SEC EDGAR. Each Form 144 and Form 144/A filing is parsed into one structured notice.How fast do new notices show up?
Within minutes of each filing.How is a sale notice different from an insider trade?
A sale notice (Form 144) says an insider plans to sell, and it is filed with the sell order. An insider trade (Form 4) reports a completed buy or sale, up to two business days after it happens. Use this API for the early signal and the insider trades API for the completed trade.What happens when a notice is corrected?
The seller files a Form 144/A. The API then returns the corrected notice in place of the notice it replaces, andreplaces_accession_number names that notice.
How far back does the data go?
It is complete from April 13, 2023, and includes the notices filed electronically from September 2022.Can I get a webhook for each new notice?
Yes. Subscribe toinsider_sale_notices.created.