{
  "openapi": "3.0.3",
  "info": {
    "title": "SEC Insider Trades API (Form 4)",
    "version": "1.0.0",
    "description": "Who is buying and selling their own company stock: SEC Form 4 insider transactions by ticker, insider or company, from official EDGAR data. Responses are JSON {count, limit, results[], request_id}; errors are {error:{code,message,param?},request_id}. Requests are capped per call and time out after 25 seconds. Try it without a key at https://api.impakt.dev. Demo calls are capped at 5 per address per day and $0.50 for everyone per UTC day."
  },
  "servers": [
    {
      "url": "https://api.impakt.dev",
      "description": "Public API at https://api.impakt.dev."
    }
  ],
  "tags": [
    {
      "name": "SEC"
    }
  ],
  "paths": {
    "/sec/insider-trades": {
      "get": {
        "operationId": "findInsiderTrades",
        "tags": [
          "SEC"
        ],
        "summary": "Insider buys and sells from SEC Form 4 filings",
        "description": "Transactions reported by company insiders (officers, directors, 10% owners) on SEC Form 4, from official EDGAR data. At least one of ticker, insider or company is required. Defaults to open-market buys and sells filed in the last 7 days. Each row is one transaction with a plain-language label, shares, price, USD value, shares owned afterwards and the SEC filing link.",
        "parameters": [
          {
            "name": "ticker",
            "in": "query",
            "required": false,
            "description": "Comma-separated stock tickers (max 3). Each ticker is at most 10 characters. One of ticker, insider or company is required.",
            "schema": {
              "type": "string"
            },
            "example": "NVDA,AAPL"
          },
          {
            "name": "insider",
            "in": "query",
            "required": false,
            "description": "Comma-separated words in the insider name (max 3).",
            "schema": {
              "type": "string"
            },
            "example": "Cook"
          },
          {
            "name": "company",
            "in": "query",
            "required": false,
            "description": "Comma-separated words in the issuer name (max 3).",
            "schema": {
              "type": "string"
            },
            "example": "tesla"
          },
          {
            "name": "transaction_type",
            "in": "query",
            "required": false,
            "description": "buy = open-market purchases, sell = open-market sales, buy_sell = both, all = every non-derivative transaction code (grants, gifts, tax withholding, exercises).",
            "schema": {
              "type": "string",
              "enum": [
                "buy",
                "sell",
                "buy_sell",
                "all"
              ],
              "default": "buy_sell"
            }
          },
          {
            "name": "min_value_usd",
            "in": "query",
            "required": false,
            "description": "Minimum shares x price in USD. Maximum 100000000000.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100000000000,
              "default": 0
            },
            "example": 100000
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "Filed in the last N days (ignored when date_from is set).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 14,
              "default": 7
            }
          },
          {
            "name": "date_from",
            "in": "query",
            "required": false,
            "description": "Window start (YYYY-MM-DD); an inclusive window may span at most 14 days (date_to minus date_from <= 14).",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "example": "2026-11-05"
          },
          {
            "name": "date_to",
            "in": "query",
            "required": false,
            "description": "Window end, inclusive (default today).",
            "schema": {
              "type": "string",
              "format": "date"
            },
            "example": "2026-11-18"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum transactions returned (1 to 10). The Worker reads at most 80 filings per call, so a busy ticker may return fewer rows than this.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 10,
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InsiderResponse"
                },
                "example": {
                  "count": 1,
                  "limit": 1,
                  "results": [
                    {
                      "formType": "4",
                      "isAmendment": false,
                      "filingDate": "2026-11-18",
                      "periodOfReport": "2026-11-16",
                      "issuer": "Apple Inc.",
                      "issuerCik": "0000320193",
                      "ticker": "AAPL",
                      "insider": "LEVINSON ARTHUR D",
                      "insiderCik": "0001214128",
                      "role": "Director",
                      "officerTitle": null,
                      "isDirector": true,
                      "isOfficer": false,
                      "isTenPercentOwner": false,
                      "jointFilers": [],
                      "tradingPlan10b5_1": false,
                      "accessionNumber": "0001140361-26-044773",
                      "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000114036126044773/0001140361-26-044773-index.htm",
                      "security": "Common Stock",
                      "isDerivative": false,
                      "transactionDate": "2026-11-16",
                      "transactionCode": "S",
                      "transactionLabel": "Open-market or private sale",
                      "direction": "disposed",
                      "shares": 36792,
                      "pricePerShare": 352.26,
                      "valueUsd": 12960349.92,
                      "sharesOwnedAfter": 3662784,
                      "ownership": "Direct",
                      "ownershipNature": null
                    }
                  ],
                  "request_id": "00000000-0000-4000-8000-000000000000"
                }
              }
            }
          },
          "400": {
            "description": "Invalid parameter or body.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Missing or invalid marketplace secret (call through the marketplace).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "The backend rejected the input.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Temporarily unavailable or daily capacity reached. Retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "504": {
            "description": "Took longer than 25 seconds; reduce the amount of work.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "InsiderTrade": {
        "type": "object",
        "properties": {
          "formType": {
            "type": "string"
          },
          "isAmendment": {
            "type": "boolean"
          },
          "filingDate": {
            "type": "string"
          },
          "periodOfReport": {
            "type": "string"
          },
          "issuer": {
            "type": "string"
          },
          "issuerCik": {
            "type": "string"
          },
          "ticker": {
            "type": "string"
          },
          "insider": {
            "type": "string"
          },
          "insiderCik": {
            "type": "string"
          },
          "role": {
            "type": "string"
          },
          "officerTitle": {
            "nullable": true,
            "type": "string"
          },
          "isDirector": {
            "type": "boolean"
          },
          "isOfficer": {
            "type": "boolean"
          },
          "isTenPercentOwner": {
            "type": "boolean"
          },
          "jointFilers": {
            "type": "array",
            "items": {}
          },
          "tradingPlan10b5_1": {
            "type": "boolean"
          },
          "accessionNumber": {
            "type": "string"
          },
          "filingUrl": {
            "type": "string"
          },
          "security": {
            "type": "string"
          },
          "isDerivative": {
            "type": "boolean"
          },
          "transactionDate": {
            "type": "string"
          },
          "transactionCode": {
            "type": "string"
          },
          "transactionLabel": {
            "type": "string"
          },
          "direction": {
            "type": "string"
          },
          "shares": {
            "type": "integer"
          },
          "pricePerShare": {
            "type": "number"
          },
          "valueUsd": {
            "type": "number"
          },
          "sharesOwnedAfter": {
            "type": "integer"
          },
          "ownership": {
            "type": "string"
          },
          "ownershipNature": {
            "nullable": true,
            "type": "string"
          }
        },
        "description": "One InsiderTrade record. Fields not offered by a source are null; some fields are omitted depending on the request (see property descriptions)."
      },
      "InsiderResponse": {
        "type": "object",
        "required": [
          "count",
          "limit",
          "results",
          "request_id"
        ],
        "properties": {
          "count": {
            "type": "integer",
            "description": "Number of records returned."
          },
          "limit": {
            "type": "integer",
            "description": "Maximum records for this call."
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/InsiderTrade"
            }
          },
          "request_id": {
            "type": "string",
            "format": "uuid"
          }
        }
      },
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message"
            ],
            "properties": {
              "code": {
                "type": "string",
                "example": "invalid_parameter"
              },
              "message": {
                "type": "string"
              },
              "param": {
                "type": "string"
              }
            }
          },
          "request_id": {
            "type": "string",
            "format": "uuid"
          }
        }
      }
    }
  }
}
