# SEC EDGAR Insider Trading Crawler (Form 4) (`jungle_synthesizer/sec-insider-trading-crawler`) Actor Scrape SEC EDGAR Form 4 insider trading filings. Extract structured transaction data: who bought or sold, how many shares, at what price, and their role. Filter by ticker, date range, and transaction type. 500K+ filings per year. - **URL**: https://apify.com/jungle\_synthesizer/sec-insider-trading-crawler.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Business, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## SEC EDGAR Insider Trading Crawler (Form 4) Scrapes Form 4 filings from [SEC EDGAR](https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&type=4). Returns one structured transaction record per buy, sell, grant, or disposition — with the insider's name, role, shares traded, price, and company — across 500K+ filings per year. --- ### SEC EDGAR Insider Trading Crawler Features - Extracts every transaction in a date range — non-derivative and derivative positions both covered - Filters by ticker symbol, transaction code (P/S/A/D/F/M), or both - Returns 23 fields per transaction including insider identity, role flags, and SEC accession number - Parses SEC XML directly — no browser required, no proxies needed - Handles SEC rate limits automatically (10 req/sec cap, politely observed) - Configurable max items so you can sample before committing to a full pull --- ### What Can You Do With SEC Form 4 Data? - **Quantitative researchers** — build insider-trading signals for systematic strategies, or at least the dataset that makes building them less miserable - **Compliance teams** — monitor executive transactions at portfolio companies in near-real-time - **Journalists and analysts** — surface large purchases or unusual sales around earnings announcements - **Financial data vendors** — backfill or supplement insider ownership datasets with structured EDGAR records - **Retail investors** — track what officers and directors at specific companies are actually doing with their own shares --- ### How the SEC EDGAR Insider Trading Crawler Works 1. Queries the EDGAR Full-Text Search API for Form 4 filings in your specified date range, paginating through results in batches of 100 2. For each filing, fetches the raw XML document directly from the SEC Archives 3. Parses each XML with full transaction detail — issuer info, reporting owner identity, transaction codes, share counts, prices, and footnotes 4. Applies any ticker or transaction code filters you configured, then saves matching records --- ### Input ```json { "startDate": "2025-01-01", "endDate": "2025-01-07", "tickers": ["AAPL", "MSFT"], "transactionCodes": ["P", "S"], "maxItems": 100 } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `startDate` | string | 30 days ago | Start of the filing date range (YYYY-MM-DD) | | `endDate` | string | today | End of the filing date range (YYYY-MM-DD) | | `tickers` | array | `[]` | Filter by stock ticker symbols. Empty = all tickers | | `transactionCodes` | array | `[]` | Filter by SEC code. P=Purchase, S=Sale, A=Award, D=Disposition, F=Tax withholding, M=Option exercise. Empty = all codes | | `maxItems` | integer | 15 | Maximum transaction records to return | **Pull everything for a week:** ```json { "startDate": "2025-03-10", "endDate": "2025-03-14", "maxItems": 10000 } ``` **Just purchases at one company:** ```json { "startDate": "2025-01-01", "endDate": "2025-12-31", "tickers": ["TSLA"], "transactionCodes": ["P"], "maxItems": 500 } ``` *** ### SEC EDGAR Insider Trading Crawler Output Fields ```json { "accession_number": "0000320193-25-000035", "filing_date": "2025-02-27", "period_of_report": "2025-02-25", "reporting_owner_name": "SUGAR RONALD D", "reporting_owner_cik": "0001216519", "reporting_owner_is_director": true, "reporting_owner_is_officer": false, "reporting_owner_officer_title": "", "reporting_owner_is_ten_percent_owner": false, "issuer_name": "Apple Inc.", "issuer_cik": "0000320193", "issuer_ticker": "AAPL", "transaction_type": "non-derivative", "security_title": "Common Stock", "transaction_date": "2025-02-25", "transaction_code": "A", "acquired_or_disposed": "A", "shares_traded": 2416, "price_per_share": 0, "total_value": 0, "shares_owned_after": 37481, "ownership_nature": "D", "footnotes": "", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000035/wk-form4_1740699290.xml" } ``` | Field | Type | Description | |-------|------|-------------| | `accession_number` | string | SEC EDGAR accession number (unique filing identifier) | | `filing_date` | string | Date the Form 4 was filed with the SEC (YYYY-MM-DD) | | `period_of_report` | string | Date of the reported transaction (YYYY-MM-DD) | | `reporting_owner_name` | string | Full name of the insider/reporting owner | | `reporting_owner_cik` | string | SEC CIK number of the reporting owner | | `reporting_owner_is_director` | boolean | True if the insider is a board director | | `reporting_owner_is_officer` | boolean | True if the insider is a company officer | | `reporting_owner_officer_title` | string | Officer title (e.g. Chief Executive Officer) if applicable | | `reporting_owner_is_ten_percent_owner` | boolean | True if the insider owns 10% or more of the issuer | | `issuer_name` | string | Name of the company (issuer) | | `issuer_cik` | string | SEC CIK number of the issuer company | | `issuer_ticker` | string | Stock ticker symbol of the issuer | | `transaction_type` | string | Type of security: `non-derivative` or `derivative` | | `security_title` | string | Name/title of the security (e.g. Common Stock, Stock Option) | | `transaction_date` | string | Date the transaction occurred (YYYY-MM-DD) | | `transaction_code` | string | SEC code: P=Purchase, S=Sale, A=Award, D=Disposition, F=Tax-withholding, M=Option-exercise | | `acquired_or_disposed` | string | A if shares were acquired, D if disposed | | `shares_traded` | number | Number of shares bought, sold, or transferred | | `price_per_share` | number | Price per share (0 for awards, withholding, and other non-cash events) | | `total_value` | number | Computed total value: shares\_traded x price\_per\_share | | `shares_owned_after` | number | Total shares owned by the insider after the transaction | | `ownership_nature` | string | D for direct ownership, I for indirect (e.g. held by a family trust) | | `footnotes` | string | Footnotes from the filing, concatenated with pipe separator | | `filing_url` | string | URL to the Form 4 XML document on SEC EDGAR | *** ### 🔍 FAQ #### How do I scrape SEC Form 4 insider trading data? SEC EDGAR Insider Trading Crawler queries the EDGAR full-text search API for Form 4 filings in your date range, fetches each XML document, and parses every transaction. Set `startDate`, `endDate`, and `maxItems` — that's the minimum. Ticker and transaction code filters are optional. #### How much does the SEC EDGAR Insider Trading Crawler cost to run? The actor charges $0.10 per run plus $0.001 per transaction record. A week of Form 4 data covering all companies typically runs a few hundred to a few thousand records depending on your filters. #### Does the crawler need proxies? No. SEC EDGAR is a government data service designed for public access. The crawler identifies itself via the required User-Agent header and respects the 10 req/sec rate limit. #### Can I filter by specific companies? Yes. Pass one or more tickers in the `tickers` field — e.g. `["AAPL", "MSFT", "NVDA"]`. The filter is applied after parsing, so the crawler fetches all filings in the date range and returns only matching records. Narrow your date range for faster results when filtering by ticker. #### What's the difference between transaction codes? P = open-market purchase. S = open-market sale. A = award or grant (note `price_per_share` will be 0 — these are non-cash events). D = disposition other than sale. F = shares withheld for tax at vesting. M = option exercise. Most insider-trading signals focus on P and S. #### How far back does the data go? EDGAR Full-Text Search covers filings back to the late 1990s. The pagination limit is 10,000 results per query, so for high-volume date ranges split your pull into narrower windows. *** ### Need More Features? Need custom fields, additional filing types, or a bulk historical pull? [File an issue](https://console.apify.com/actors/mqKJgHNRHtIMHm8f2/issues) or get in touch. ### Why Use SEC EDGAR Insider Trading Crawler? - **Structured output, not raw XML** — returns clean JSON records with typed fields, not the raw SEC filing format you'd otherwise have to parse yourself - **No auth, no proxies, no maintenance** — SEC EDGAR is a stable government API. The crawler runs the same today as it did last quarter. - **Granular transaction-level records** — one Form 4 can contain multiple transactions across different securities. The crawler expands all of them. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `startDate` (type: `string`): Start of the filing date range (YYYY-MM-DD). Defaults to 30 days ago if omitted. ## `endDate` (type: `string`): End of the filing date range (YYYY-MM-DD). Defaults to today if omitted. ## `tickers` (type: `array`): Filter by one or more stock ticker symbols (e.g. AAPL, MSFT). Leave empty to fetch all tickers in the date range. ## `transactionCodes` (type: `array`): Filter by SEC transaction code. P=Purchase, S=Sale, A=Award/Grant, D=Disposition, F=Tax withholding, M=Option exercise. Leave empty for all types. ## `maxItems` (type: `integer`): Maximum number of transaction records to return. Each Form 4 filing may produce multiple records. Set to 0 for unlimited. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "startDate": "2025-01-01", "endDate": "2025-01-07", "tickers": [], "transactionCodes": [], "maxItems": 15 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "startDate": "2025-01-01", "endDate": "2025-01-07", "tickers": [], "transactionCodes": [], "maxItems": 15 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/sec-insider-trading-crawler").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "startDate": "2025-01-01", "endDate": "2025-01-07", "tickers": [], "transactionCodes": [], "maxItems": 15, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/sec-insider-trading-crawler").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "startDate": "2025-01-01", "endDate": "2025-01-07", "tickers": [], "transactionCodes": [], "maxItems": 15 }' | apify call jungle_synthesizer/sec-insider-trading-crawler --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/sec-insider-trading-crawler", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SEC EDGAR Insider Trading Crawler (Form 4)", "description": "Scrape SEC EDGAR Form 4 insider trading filings. Extract structured transaction data: who bought or sold, how many shares, at what price, and their role. Filter by ticker, date range, and transaction type. 500K+ filings per year.", "version": "0.1", "x-build-id": "n2Mu9nTQixGoGbD5H" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~sec-insider-trading-crawler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-sec-insider-trading-crawler", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jungle_synthesizer~sec-insider-trading-crawler/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-sec-insider-trading-crawler", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jungle_synthesizer~sec-insider-trading-crawler/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-sec-insider-trading-crawler", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "startDate": { "title": "Start Date", "type": "string", "description": "Start of the filing date range (YYYY-MM-DD). Defaults to 30 days ago if omitted." }, "endDate": { "title": "End Date", "type": "string", "description": "End of the filing date range (YYYY-MM-DD). Defaults to today if omitted." }, "tickers": { "title": "Ticker Symbol(s)", "type": "array", "description": "Filter by one or more stock ticker symbols (e.g. AAPL, MSFT). Leave empty to fetch all tickers in the date range.", "items": { "type": "string" } }, "transactionCodes": { "title": "Transaction Codes", "type": "array", "description": "Filter by SEC transaction code. P=Purchase, S=Sale, A=Award/Grant, D=Disposition, F=Tax withholding, M=Option exercise. Leave empty for all types.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum number of transaction records to return. Each Form 4 filing may produce multiple records. Set to 0 for unlimited.", "default": 15 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```