{ "openapi": "3.0.1", "info": { "title": "SEC Form 4 Insider Trading Tracker: Every Insider Buy and Sell", "description": "Track SEC Form 4 insider trading filings from EDGAR. Filter by ticker, CIK, transaction code, insider role, min value, and age. Returns deduped JSON of every insider buy, sell, grant, and option exercise. Official EDGAR APIs, no HTML scraping.", "version": "0.1", "x-build-id": "ujXdFsrCjCup9tzdE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapemint~sec-form4-insider-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapemint-sec-form4-insider-tracker", "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/scrapemint~sec-form4-insider-tracker/runs": { "post": { "operationId": "runs-sync-scrapemint-sec-form4-insider-tracker", "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/scrapemint~sec-form4-insider-tracker/run-sync": { "post": { "operationId": "run-sync-scrapemint-sec-form4-insider-tracker", "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": { "tickers": { "title": "Tickers to watch", "type": "array", "description": "Stock tickers whose insider filings you want to pull. Example: AAPL, TSLA, NVDA. The actor resolves each ticker to a CIK using EDGAR's public ticker map. Leave empty if you are using CIKs below.", "items": { "type": "string" } }, "ciks": { "title": "CIKs to watch", "type": "array", "description": "SEC Central Index Keys. Use these if you want companies that do not have a single public ticker. Leading zeros are optional. Example: 320193 for Apple.", "default": [], "items": { "type": "string" } }, "transactionCodes": { "title": "Transaction codes filter", "type": "array", "description": "Only keep transactions with these Form 4 codes. P = open market purchase, S = open market sale, A = grant or award, F = tax withholding, M = option exercise, D = disposition, G = gift. Leave empty to keep every code.", "default": [], "items": { "type": "string" } }, "reporterRoles": { "title": "Insider role filter", "type": "array", "description": "Only keep filings where the insider matches any of these roles. Options: director, officer, ten_percent_owner, other. Leave empty to keep every role.", "default": [], "items": { "type": "string" } }, "minTransactionValue": { "title": "Minimum transaction value (USD)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Drop transactions where shares times price per share is below this floor. Set to 0 to keep every transaction. Useful when you only care about large insider buys.", "default": 0 }, "minShares": { "title": "Minimum shares", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Drop transactions with fewer than this many shares. Set to 0 to keep everything.", "default": 0 }, "includeDerivative": { "title": "Include derivative transactions", "type": "boolean", "description": "Keep derivative security rows: options grants, RSU vesting, warrants, convertibles. Turn off if you only want direct stock transactions.", "default": true }, "includeNonDerivative": { "title": "Include non derivative transactions", "type": "boolean", "description": "Keep direct stock transactions. Almost always yes. Turn off only if you want to isolate derivative activity.", "default": true }, "maxAgeHours": { "title": "Max age in hours", "minimum": 0, "maximum": 17520, "type": "integer", "description": "Skip filings submitted more than this many hours ago. Default is 168 hours (one week). Set to 0 to keep every filing in EDGAR's recent window (last ~1000 filings per company).", "default": 168 }, "maxItemsPerSource": { "title": "Max items per company", "minimum": 1, "maximum": 500, "type": "integer", "description": "Per ticker cap on Form 4 filings processed. Each filing can expand to multiple transaction rows. Controls how deep the actor looks back for a single company.", "default": 50 }, "maxItemsTotal": { "title": "Maximum items per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on transactions pushed to the dataset per run. Controls total cost.", "default": 200 }, "dedupe": { "title": "Deduplicate across runs", "type": "boolean", "description": "Skip Form 4 accession numbers pushed on previous runs. Stored in the key value store under SEEN_IDS. Turn off to return every matching transaction every run.", "default": true }, "userAgent": { "title": "User-Agent (required by SEC)", "type": "string", "description": "SEC requires a descriptive User-Agent with a contact email. Example: MyCompany Research research@mycompany.com. Without a valid email the EDGAR endpoints return 403.", "default": "Scrapemint Form4 Tracker research@scrapemint.com" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. EDGAR is public and rate limited at 10 req/sec per User-Agent, not per IP, so a proxy is rarely needed. Add one if you trigger secondary limits." } } }, "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 } } } } } } } } } }