{ "openapi": "3.0.1", "info": { "title": "SEC Form 4 Insider Trades by Ticker", "description": "Parsed insider transactions from SEC Form 4 filings for any US ticker: buys, sales, grants, option exercises, 10b5-1 flags, with reporter role and post-transaction holdings.", "version": "0.1", "x-build-id": "y5iCWgb9wLMzBPW5n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codecraftco~sec-insider-trades/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codecraftco-sec-insider-trades", "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/codecraftco~sec-insider-trades/runs": { "post": { "operationId": "runs-sync-codecraftco-sec-insider-trades", "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/codecraftco~sec-insider-trades/run-sync": { "post": { "operationId": "run-sync-codecraftco-sec-insider-trades", "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": { "companies": { "title": "Companies", "uniqueItems": true, "type": "array", "description": "Issuers by company name, ticker, or SEC CIK, e.g. Apple, NVDA, 0000789019. Tickers are looked up in the SEC's ticker file, which the SEC updates periodically but does not guarantee. How each entry matched is saved in the QUERIES record.", "items": { "type": "string" } }, "insiders": { "title": "Insiders", "uniqueItems": true, "type": "array", "description": "Reporting owners, the people and entities that file Forms 3, 4 and 5, by name or SEC CIK. Returns the filings on which they are a reporting owner, at every issuer. Entities that have filed as a reporting owner are ranked first when a name matches several.", "items": { "type": "string" } }, "marketWide": { "title": "Market-wide", "type": "boolean", "description": "Every Form 4 and 5 filed in the date range, across all issuers, read from the index this actor keeps, which holds the last year of filings through its latest nightly update. Combine with Purchases and sales only, Acquired or disposed, and Minimum insiders.", "default": false }, "startDate": { "title": "Start date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only filings with a filing date on or after this date (YYYY-MM-DD). With no dates and no filing limit, the last 30 days." }, "endDate": { "title": "End date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only filings with a filing date on or before this date (YYYY-MM-DD). Defaults to today." }, "maxFilings": { "title": "Max filings per company or insider", "minimum": 1, "type": "integer", "description": "Keep only the newest this many filings for each company or insider. With no dates, it replaces the 30-day default, so you can ask for, say, the last 50 filings however old." }, "purchasesAndSalesOnly": { "title": "Purchases and sales only (P, S)", "type": "boolean", "description": "Only transaction codes P (\"Open market or private purchase of non-derivative or derivative security\") and S (\"Open market or private sale of non-derivative or derivative security\"), as Form 4 General Instruction 8 defines them. The code does not say which of the two, open market or private, a trade was.", "default": false }, "direction": { "title": "Acquired or disposed", "enum": [ "all", "acquired", "disposed" ], "type": "string", "description": "Only transactions the filing marks as acquired (A) or as disposed (D).", "default": "all" }, "minValue": { "title": "Minimum transaction value (USD)", "minimum": 0, "type": "integer", "description": "Only transactions whose value, shares times the reported price per share, is at least this many U.S. dollars. Transactions with no price are left out when this is set." }, "minInsiders": { "title": "Minimum insiders per company", "minimum": 2, "type": "integer", "description": "Only issuers where at least this many different reporting owners, by CIK, appear in the results after all other filters." }, "transactionCodes": { "title": "Transaction codes", "uniqueItems": true, "type": "array", "description": "Only these transaction codes, from Form 4 General Instruction 8; empty for all. These are the codes a filing carries. EDGAR adds V and K to the printed form only: K for an equity swap (equitySwapInvolved), V for a transaction reported early (transactionFormType 5 on a Form 4).", "items": { "type": "string", "enum": [ "P", "S", "A", "D", "F", "I", "M", "C", "E", "H", "O", "X", "G", "L", "W", "Z", "J", "U" ], "enumTitles": [ "P - Open market or private purchase of non-derivative or derivative security", "S - Open market or private sale of non-derivative or derivative security", "A - Grant, award or other acquisition pursuant to Rule 16b-3(d)", "D - Disposition to the issuer of issuer equity securities pursuant to Rule 16b-3(e)", "F - Payment of exercise price or tax liability by delivering or withholding securities incident to the receipt, exercise or vesting of a security issued in accordance with Rule 16b-3", "I - Discretionary transaction in accordance with Rule 16b-3(f) resulting in acquisition or disposition of issuer securities", "M - Exercise or conversion of derivative security exempted pursuant to Rule 16b-3", "C - Conversion of derivative security", "E - Expiration of short derivative position", "H - Expiration (or cancellation) of long derivative position with value received", "O - Exercise of out-of-the-money derivative security", "X - Exercise of in-the-money or at-the-money derivative security", "G - Bona fide gift", "L - Small acquisition under Rule 16a-6", "W - Acquisition or disposition by will or the laws of descent and distribution", "Z - Deposit into or withdrawal from voting trust", "J - Other acquisition or disposition (describe transaction)", "U - Disposition pursuant to a tender of shares in a change of control transaction" ] } }, "includeDerivatives": { "title": "Include derivative transactions", "type": "boolean", "description": "Include Table II transactions: derivative securities, e.g. puts, calls, options, warrants, convertible securities, or other rights or obligations to buy or sell securities.", "default": true }, "includeAmendments": { "title": "Include amended filings (4/A, 5/A)", "type": "boolean", "description": "Also return 4/A and 5/A. An amendment carries only the lines it adds or amends, names the filing it amends only by the date the original was filed (dateOfOriginalSubmission), and does not link an amended line to the line it replaces.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }