Get Insider Transactions
secedgar_get_insider_transactionsFetch Form 4 insider transactions (purchases, sales, grants, exercises) for a company by parsing SEC EDGAR ownership XML. Returns the reporting person, their relationship to the issuer, transaction date, type, shares traded (absolute magnitude), direction (acquire/dispose), price per share, and shares owned after the transaction. Covers nonDerivative transactions (open-market buys/sells, gifts) and derivative transactions (option exercises, RSU vests). Without a date window it reads the newest Form 4 filings; filed_after / filed_before read any period since mid-2003, reaching past the recent submissions window into the archive (e.g. insider trades in the quarter before an earnings miss). When a canvas is available, the full set of transactions parsed from the scanned filings is materialized as df_ (the inline list is a preview capped at limit) — inspect it with secedgar_dataframe_describe, then query it with secedgar_dataframe_query to aggregate net buy/sell by insider: SUM(CASE WHEN direction='dispose' THEN -shares_traded ELSE shares_traded END). Use secedgar_search_filings with forms=["4"] to search Form 4 filings across all companies.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"company": "<company>"
},
"name": "secedgar_get_insider_transactions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of transactions to return across all Form 4 filings fetched. Filings are scanned newest-first. Default 20. Capped at 100: a larger value, up to 1000, returns what 100 returns. | |
| company | Yes | The issuer whose Form 4 filings to read — the company, not the reporting person. A ticker symbol (e.g., "AAPL"), a CIK with or without zero-padding (e.g., "320193" or "0000320193"), or a company name (current or former). A name matching several companies fails and lists them, so retry with one's ticker or CIK. | |
| filed_after | No | Only read Form 4 filings filed on or after this date (YYYY-MM-DD). A date window reaches filings older than the recent submissions window by paging into the archive, and with a canvas every Form 4 filed inside it is parsed, up to 100. Structured Form 4 XML begins in mid-2003, so an earlier window finds nothing. | |
| filed_before | No | Only read Form 4 filings filed on or before this date (YYYY-MM-DD). Use alone or with filed_after. Without either bound the tool reads the newest Form 4 filings. | |
| transaction_type | No | Filter by direction. "purchase" = open-market buys (code P). "sale" = open-market sells (code S). "all" includes grants, awards, exercises, gifts, and other coded transaction types as well. | all |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit cap applied. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of transactions shown inline. | |
| notice | No | Why the result is empty (the filter, or every scanned filing naming another issuer), and the dataframe pointer when staged. | |
| dataset | No | Dataframe of every parsed transaction, issuer keys on each row, for net buy/sell by insider and cross-issuer joins. Absent when canvas is unavailable or nothing parsed. | |
| truncated | No | True when the inline transactions[] was capped by limit. | |
| issuer_cik | No | Issuer CIK, zero-padded to 10 digits. | |
| resolvedAs | No | How the input was read: a ticker spelling, former ticker, earlier holder, or entity-index match. | |
| issuer_name | No | Issuer entity name (SEC-conformed). | |
| transactions | No | Insider transactions, newest filing first, capped at limit; the dataframe holds the full parsed set. | |
| issuer_ticker | No | Issuer ticker symbol when available. | |
| filings_scanned | No | Form 4 filings scanned, including those in filings_other_issuer. | |
| filings_other_issuer | No | Scanned Form 4 filings naming a different issuer, filed by this company as that issuer's reporting owner (e.g., a 10% holder of a fund); they add no transactions here or to the dataframe. | |
| history_scanned_through | No | Filing date of the oldest Form 4 parsed (YYYY-MM-DD). Present only with a date window that held a Form 4. |