{"id":2769,"date":"2026-05-25T21:29:00","date_gmt":"2026-05-25T19:29:00","guid":{"rendered":"https:\/\/eodhd.com\/financial-apis\/?p=2769"},"modified":"2026-07-22T14:41:21","modified_gmt":"2026-07-22T12:41:21","slug":"insider-transactions-api","status":"publish","type":"post","link":"https:\/\/eodhd.com\/financial-apis\/insider-transactions-api","title":{"rendered":"Insider Transactions API (SEC “Form 4”)"},"content":{"rendered":"\n

The EODHD Insider Transactions API provides Form 4 filings \u2014 the public disclosure of stock transactions by directors, officers, and 10% owners of US-listed companies as required by Section 16 of the Securities Exchange Act. Each filing exposes non-derivative transactions (common stock), derivative transactions (stock options, RSUs, warrants), and the footnotes referenced from each row. Data is sourced directly from SEC EDGAR and refreshed on a daily schedule.<\/p>\n\n\n\n

Coverage is limited to US-listed issuers that file Form 4 with the SEC.<\/p>\n\n\n\n

<\/p>\n\n\n

\n <\/svg><\/span>\n
\n\n

You can try this endpoint without an account using the demo API token (api_token=demo). For SEC filings the demo token is limited to three tickers: AAPL.US<\/strong>, TSLA.US<\/strong>, and AMZN.US<\/strong>.<\/p>\n\n<\/div>\n <\/div>\n \n\n

\n <\/svg><\/span>\n
\n\n

The legacy \/api\/insider-transactions endpoint is obsolete. It remains available for backward compatibility and still returns the same flat schema (see the Legacy Endpoint section at the end of this page). For all new integrations, use the SEC Form 4 endpoint described below.<\/p>\n\n<\/div>\n <\/div>\n \n\n\n

<\/div>\n\n\n\n

Coverage<\/h2>\n\n\n\n

Form 4 filings are sourced from SEC EDGAR and refreshed daily, with history reaching back to 2000.<\/p>\n\n\n\n

Metric<\/th>Value<\/th><\/tr><\/thead>
Filings<\/td>1,470,000+<\/td><\/tr>
Issuers<\/td>4,800+<\/td><\/tr>
History<\/td>2000 to present<\/td><\/tr>
Non-derivative transactions<\/td>2.4 million+<\/td><\/tr>
Derivative transactions<\/td>889,000+<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Nearly all filings, about 99.6 percent, include at least one transaction. The small remainder are holdings-only or amendment filings, which is normal. Depth per issuer varies: major US large-caps have a decade or more of history, while recently listed names have less.<\/p>\n\n\n\n

Compared with the legacy endpoint, the SEC Form 4 endpoint provides direct SEC EDGAR data with fewer data-quality issues, up to a decade or more of history for major issuers, both non-derivative and derivative transactions with footnotes, the full SEC transaction code set, and reporting-owner CIK, relationship flags, and post-transaction holdings on every row.<\/p>\n\n\n\n

<\/div>\n\n\n\n

API Endpoint<\/h2>\n\n\n
\n
GET https:\/\/eodhd.com\/api\/sec-filings\/{symbol}\/form4<\/code><\/pre>\n<\/div>\n\n\n
<\/div>\n\n\n\n
Path Parameter<\/h2>\n\n\n
\n    \n
\n    
\n                    symbol<\/code>\n        \n                    string<\/span>\n        \n        \n            required        <\/span>\n    <\/div>\n\n    
\n        US ticker, for example AAPL or AAPL.US. Case-insensitive, and the .US suffix is optional. Form 4 is filed by US-listed issuers only.<\/span>\n            <\/div>\n<\/div>\n\n<\/div>\n\n\n\n
<\/div>\n\n\n\n
Query Parameters<\/h2>\n\n\n
\n    \n
\n    
\n                    api_token<\/code>\n        \n                    string<\/span>\n        \n        \n            required        <\/span>\n    <\/div>\n\n    
\n        Your EODHD API token<\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    page[offset]<\/code>\n        \n                    integer<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Pagination offset, zero-based<\/span>\n                    (Default: 0)<\/em><\/span>\n            <\/div>\n<\/div>\n\n\n
\n    
\n                    page[limit]<\/code>\n        \n                    integer<\/span>\n        \n        \n            optional        <\/span>\n    <\/div>\n\n    
\n        Page size<\/span>\n                    (Default: 20, Range: 1-100)<\/em><\/span>\n            <\/div>\n<\/div>\n\n<\/div>\n\n\n\n
<\/div>\n\n\n\n
Transaction Codes<\/h2>\n\n\n\n
The transaction_code field uses the SEC Section 16 reporting codes. Both non-derivative and derivative transactions share the same code set:<\/p>\n\n\n\n
Code<\/th>Description<\/th><\/tr><\/thead>
P<\/td>Open-market or private purchase of non-derivative or derivative security<\/td><\/tr>
S<\/td>Open-market or private sale of non-derivative or derivative security<\/td><\/tr>
A<\/td>Grant, award, or other acquisition under an equity-based compensation plan<\/td><\/tr>
D<\/td>Disposition to the issuer of securities under an equity-based compensation plan<\/td><\/tr>
F<\/td>Payment of exercise price or tax liability by delivering or withholding shares<\/td><\/tr>
M<\/td>Exercise or conversion of derivative security received under an equity-based compensation plan<\/td><\/tr>
G<\/td>Bona fide gift<\/td><\/tr>
V<\/td>Voluntarily reported transaction otherwise not required to be reported<\/td><\/tr>
J<\/td>Other acquisition or disposition (described in a footnote)<\/td><\/tr>
L<\/td>Small acquisition under SEC Rule 16a-6<\/td><\/tr>
C<\/td>Conversion of derivative security<\/td><\/tr>
E<\/td>Expiration of short derivative position<\/td><\/tr>
H<\/td>Expiration of long derivative position with value received<\/td><\/tr>
O<\/td>Exercise of out-of-the-money derivative security<\/td><\/tr>
X<\/td>Exercise of in-the-money or at-the-money derivative security<\/td><\/tr>
I<\/td>Discretionary transaction under Rule 16b-3(f) resulting in an acquisition or disposition of issuer securities<\/td><\/tr>
U<\/td>Disposition pursuant to a tender of shares in a change-of-control transaction<\/td><\/tr>
W<\/td>Acquisition or disposition by will or the laws of descent and distribution<\/td><\/tr>
Z<\/td>Deposit into or withdrawal from a voting trust<\/td><\/tr>
K<\/td>Transaction in an equity swap or instrument with similar characteristics<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Sign up & Get Data<\/span><\/a><\/p>\n\n\n\n
<\/div>\n\n\n\n
Request Example<\/h2>\n\n\n\n
    
\n                
\n            
\n                                                                        URL<\/button>\n                                                                            cURL<\/button>\n                                                                            PHP<\/button>\n                                                                            Python<\/button>\n                                                                            R<\/button>\n                                                                            Chat GPT<\/button>\n                                                <\/div>\n            
\n