Insider trading API
Insider buys and sales from Form 4, and the holdings on Forms 3 and 5, as rows you can filter. No XML to parse.
What you get
- Rows, not XML
- Each transaction or holding is one row with its filing, issuer, reporting owners, and footnotes.
- Filter by what matters
- Filter by issuer, insider, transaction code (
Pis a purchase,Sis a sale), table, and filing date.footnote_containskeeps rows whose footnote has your text, such as 10b5-1. - Amendments applied or not
view=effectiveapplies amendments.view=as_filedlists every row as filed.- The whole filing
- Read one Form 3, 4, or 5 as filed: each reporting owner and relationship, both tables, footnotes, and signatures. Form 144 notices of planned sales are a separate route.
Example calls
Set SECBLAST_API_KEY to your key first.
Sales of Apple stock by insiders, newest first (transaction code S, Table I):
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/ownership/insiders/transactions",
params={"issuer_ticker": "AAPL", "code": "S", "table": "non_derivative", "limit": "5"},
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())One Form 3, 4, or 5 as filed:
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/filings/0001140361-26-043484/ownership",
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())In the API reference
- GET /v3/ownership/insiders/transactionsList insider transactions across filings, newest first.
- GET /v3/ownership/insiders/holdingsList insider holdings across filings, newest first.
- GET /v3/filings/{accession}/ownershipGet a Form 3, 4, or 5 as filed.
- GET /v3/ownership/proposed-salesList Form 144 notices across filings, newest first.
Questions
- What is a Form 4?
- A Form 4 reports a trade or other change in what a company's officer, director, or large shareholder owns. It is due within two business days. SEC terms explains the other EDGAR words.
- Can I list only purchases?
- Yes. Set
code=Pon GET /v3/ownership/insiders/transactions. Combine it withissuer_ticker,owner_cik, or a filing date range. - Can I find trades under a 10b5-1 plan?
- Set
footnote_contains=10b5-1. The route returns rows whose footnote contains that text. - Can I get an alert for each new Form 4?
- Yes. Create a search subscription with
formsset to4, and each new matching filing is sent to your webhook endpoint. See SEC filing alerts and webhooks.
Make your first request
Create a key, then use it in the examples above. The fees page lists what each plan includes.