Screen Insider Transactions Across Every Issuer
screen_insider_transactionsInsider transactions from every issuer at once, filtered by date range, transaction code, direction, minimum stated value, the role the filer holds and Rule 10b5-1 status. Returns one row per transaction, which is the unit to ask for when the question is about trades rather than about the people making them: which open-market purchases were filed last week, which sales were not scheduled under a plan, which directors disposed of stock above a threshold, how much of a run of selling was an option exercise rather than a decision. Each row names its issuer and its owner CIK, so an interesting row can be followed into insider_profile. For one row per person with their totals already rolled up use screen_insiders; for a single company use issuer_insider_activity. Results are paged and the page ceiling is published in the response. A Form 4 is filed within two business days of its transaction and a Form 5 annually, so this screens filings rather than trades as they happen. See /.well-known/x402 for current pricing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Restrict to filers the filing marks as a director, an officer (an executive, with their title), or a beneficial owner of more than ten percent of a class. One person can hold several of these at once. Omit to match every role. | |
| codes | No | Transaction codes to include, up to eight of them — for instance ['P'] for open-market purchases or ['P','S'] for open-market decisions in both directions. Omit to match every code. list_ownership_codes publishes the whole vocabulary with what each code actually means; filtering to codes other than S correctly yields no realized proceeds. | |
| limit | No | Transaction rows per page, newest first. Accepts 1 to 100; defaults to 50 when omitted. The ceiling cannot be raised by a parameter and is published in the response. | |
| offset | No | Rows to skip before this page, for paging through a result set. Accepts 0 to 5000; defaults to 0. Narrow the filters rather than paging deeper. | |
| end_date | No | Latest transaction date to include, inclusive, as YYYY-MM-DD. Leave it out for an open-ended range running to the newest row in the corpus. | |
| direction | No | Restrict to acquisitions ('A') or disposals ('D'), read from the filing's own acquired/disposed flag and never derived from the transaction code. A code and a direction disagree routinely: an option exercise disposes of the derivative security while acquiring common stock. Omit to match both. | |
| start_date | No | Earliest transaction date to include, inclusive, as YYYY-MM-DD. Matched against the date the transaction happened, not the date the filing arrived — the two differ by days on a Form 4 and by up to a year on a Form 5. | |
| rule_10b5_1 | No | Rule 10b5-1 status of the transaction: 'under_plan' for sales scheduled in advance under a written plan, 'not_under_plan' for those the filing states were not, and 'not_stated' for filings that say nothing at all — which is every filing before the 2022 amendments and is a different claim from 'not_under_plan'. Omit to apply no filter of any kind. | |
| min_value_usd | No | Minimum transacted value the filing itself stated, as a decimal string such as '250000' or '250000.50'. Rows the filing stated no per-share figure for are never matched by it: an absent figure is not zero, and a gift recorded without one would otherwise satisfy every threshold as a transaction that never happened. |