Insider Trading API
The Insider Trading API provides comprehensive insider trading transaction data from SEC filings (Form 3, Form 4, Form 5). Search and filter transactions by company, insider, transaction type, date range, and more.
Available endpoints:
- /v1/insidertransactions - Search and filter insider trading transactions
- /v1/insiderdetails - Get detailed transaction information for a given insider
- /v1/insiderslist - Retrieve a list of all insiders for a given company with their current share holdings
From 3,258 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 328ms | 365ms | 380ms | 583ms | 1254ms |
Didn't find what you were looking for? Suggest an improvement
/v1/insidertransactions GET
https://api.api-ninjas.com/v1/insidertransactions
Returns a list of insider trading transactions that match the specified filters. All parameters are optional and can be combined for advanced filtering.
Parameters
tickeroptionalCompany ticker symbol (e.g.,
AAPL,MSFT).cikoptionalCentral Index Key (CIK) of the company (e.g.,
789019).nameoptionalName of the insider (exact match). Use the /v1/insiderslist endpoint to look up insider names.
form_typeoptionalSEC form type:
3,4, or5.transaction_typeoptionalType of transaction (e.g.,
Purchase,Sale,Award).transaction_codeoptionalTransaction code (e.g.,
Pfor Purchase,Sfor Sale,Afor Award).transaction_dateoptionalTransaction date in
YYYY-MM-DDformat (e.g.,2024-01-15).min_transaction_dateoptionalMinimum transaction date in
YYYY-MM-DDformat.max_transaction_dateoptionalMaximum transaction date in
YYYY-MM-DDformat.insider_typeoptionalType of insider:
director(matches director or chairman),10_percent_owner(matches 10% Owner), orofficer(excludes director, 10% owner, and chairman).min_transaction_valueoptionalMinimum transaction value in USD (e.g.,
10000).max_transaction_valueoptionalMaximum transaction value in USD (e.g.,
1000000).limitoptional premium onlyMaximum number of results to return. Max value is
100. Default value is10.offsetoptional premium onlyNumber of results to skip for pagination (default: 0).
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.
accession_numberThe SEC accession number (filing ID) for the transaction.
formThe SEC form type (3, 4, or 5).
filing_dateThe date the filing was submitted to the SEC (YYYY-MM-DD).
sec_filing_urlURL to the SEC filing document.
cikThe Central Index Key (CIK) of the company.
tickerThe stock ticker symbol of the company.
company_nameThe name of the company (issuer).
insider_nameThe name of the insider who executed the transaction.
insider_positionThe position/title of the insider (e.g., CEO, Director, 10% Owner).
transaction_codeThe transaction code (e.g., P, S, A, D, F).
transaction_nameDescription of the transaction.
transaction_typeThe type of transaction (e.g., Purchase, Sale, Award).
transaction_priceThe price per share of the transaction.
sharesThe number of shares involved in the transaction.
transaction_valueThe total value of the transaction in USD.
pre_transaction_sharesThe number of shares held before the transaction.
pre_transaction_shares_valueThe total value of shares held before the transaction in USD (pre_transaction_shares × price).
remaining_sharesThe number of shares remaining after the transaction.
remaining_shares_valueThe total value of remaining shares after the transaction in USD (remaining_shares × price).
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/insidertransactions?ticker=AAPLHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/insidertransactions?ticker=AAPL" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
/v1/insiderdetails GET Premium only
https://api.api-ninjas.com/v1/insiderdetails
Returns detailed transaction information for a given insider with optional filtering by company.
Parameters
namerequiredName of the insider (exact match). Use the /v1/insiderslist endpoint to look up insider names.
company_tickeroptionalCompany ticker symbol to filter transactions (e.g.,
AAPL,MSFT).company_cikoptionalCentral Index Key (CIK) of the company to filter transactions (e.g.,
789019).
Note: The endpoint returns a maximum of 10 transactions, ordered by filing date (most recent first).
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.
insider_nameThe name of the insider.
positionThe position/title of the insider (e.g., CEO, Director, 10% Owner).
tickerThe stock ticker symbol of the company.
cikThe Central Index Key (CIK) of the company.
company_nameThe name of the company (issuer).
sharesThe number of shares currently owned by the insider (from their most recent filing's remaining_shares). May be
nullif not available.valueThe total value of the shares in USD (shares × price from most recent filing). May be
nullif not available.transactionsAn array of transaction objects with detailed information about each transaction.
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/insiderdetails?name=Timothy%20D%20Cook&company_ticker=AAPLHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/insiderdetails?name=Timothy%20Cook" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
/v1/insiderslist GET Premium only
https://api.api-ninjas.com/v1/insiderslist
Returns a list of all insiders for a given company (via ticker or CIK). For each insider, returns their name, position, and current share holdings based on their most recent filing.
Parameters
tickeroptionalCompany ticker symbol (e.g.,
AAPL,MSFT). Either ticker or CIK is required.cikoptionalCentral Index Key (CIK) of the company (e.g.,
789019). Either ticker or CIK is required.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.
insider_nameThe name of the insider.
positionThe position/title of the insider (e.g., CEO, Director, 10% Owner).
sharesThe number of shares currently owned by the insider (from their most recent filing's remaining_shares).
valueThe total value of the shares in USD (shares × price from most recent filing).
last_filing_dateThe date of the insider's most recent filing (YYYY-MM-DD).
tickerThe stock ticker symbol of the company.
cikThe Central Index Key (CIK) of the company.
company_nameThe name of the company (issuer).
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v1/insiderslist?ticker=AAPLHeaders
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/insiderslist?ticker=AAPL" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
Frequently Asked Questions
Can I use the Insider Trading API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Insider Trading API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the Insider Trading API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the Insider Trading API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.What are the three endpoints of the Insider Trading API and how do they differ?
The API offers/v1/insidertransactionsto search and filter individual transactions across companies and insiders,/v1/insiderdetailsto pull detailed transaction history for a single insider (by exactname), and/v1/insiderslistto list every insider for a company along with their current share holdings. The latter two are premium only, and you can explore the full Finance catalog on the APIs page.Where does the Insider Trading API get its data, and what filings does it cover?
All data comes from SEC insider trading filings, specifically Form 3, Form 4, and Form 5, and each record includes the originalsec_filing_urlandaccession_numberso you can trace it back to the source. For raw filing access you may also find our SEC API useful.How do I filter insider transactions by company, transaction type, or value?
On the/v1/insidertransactionsendpoint you can combine optional filters such astickerorcikfor the company,form_type(3, 4, or 5),transaction_type,insider_type(director, 10_percent_owner, or officer), date ranges viamin_transaction_dateandmax_transaction_date, and dollar thresholds withmin_transaction_valueandmax_transaction_value. To resolve a company ticker first, see the Ticker API.What fields does each transaction record include?
Each transaction returns details such asinsider_name,insider_position,transaction_code,transaction_type,transaction_price,shares,transaction_value, and holdings before and after the trade viapre_transaction_sharesandremaining_shares. To pair this with market pricing, check out the Stock Price API.