Skip to main content
GET
Get insider sale notices

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?
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.

Coverage

Electronic filing of Form 144 became mandatory on April 13, 2023. Notices that were filed electronically before that day, from September 2022, are included too.

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.

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 no ticker filter, it is the company’s main ticker.
  • name and relationships: the seller, and the seller’s relationship to the company (e.g., Officer, Director), as filed.
  • form_type: 144 for a notice, 144/A for 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_date and notice_date: the day the SEC received the notice, and the day the seller signed it.
  • securities: one entry per class of stock to sell, with shares_to_sell, market_value, shares_outstanding, approximate_sale_date, exchange, and broker.
  • acquisitions: how and when the seller got the shares, for example restricted stock units from the company. is_gift and donor_acquired_date tell 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, with sale_date, shares, and gross_proceeds. The name on 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 by ticker, 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_lte
  • filing_date_lt
  • filing_date_gte
  • filing_date_gt
  • filing_date
The 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

Example (with ticker)

Insider Sale Notices

Example (with name)

Insider Sale Notices

Example (with filing_date)

Insider Sale Notices

Example Response

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, and replaces_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 to insider_sale_notices.created.

Can an AI agent use this data?

Yes. Claude, ChatGPT, Cursor, and other MCP clients reach it through the Financial Datasets MCP server. An agent with a wallet can also pay per request with x402, with no account.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Query Parameters

ticker
string

Filter by the company's stock ticker (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.

name
string

Filter by seller name. Every word must be in the name, in any order and any case, so a last name alone is enough.

filing_date
string<date>

Filter by the date the notice was filed: equal to this date (YYYY-MM-DD).

filing_date_gte
string<date>

Filter by the date the notice was filed: on or after this date (YYYY-MM-DD).

filing_date_lte
string<date>

Filter by the date the notice was filed: on or before this date (YYYY-MM-DD).

filing_date_gt
string<date>

Filter by the date the notice was filed: after this date (YYYY-MM-DD).

filing_date_lt
string<date>

Filter by the date the notice was filed: before this date (YYYY-MM-DD).

limit
integer
default:10

The maximum number of notices to return (default: 10, max: 1000). This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

cursor
string

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

Response

Insider sale notices response

sale_notices
object[]
next_page_url
string

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.