insider_trades

Pack: insider-trading · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/insider_trades for the schema, then POST the same URL with its arguments for the data.

SEC Form 4 insider transaction filings for a US-listed company: filing date, the officer/director/10%-owner who filed, whether the filing was made under a Rule 10b5-1 trading plan (rule_10b5_1_plan true/false, null when the filing predates the April 2023 checkbox; plus the plan adoption date and footnote text when stated), and a link to the filing on EDGAR. Answers who at a company has been buying or selling its stock recently. Ticker or company name is resolved to a CIK, so results are that issuer’s filings. Response field matched_by says whether the company was matched by ticker or by company name.

Parameters

NameTypeRequiredDescription
tickerstringyesStock ticker (“AAPL”, “NVDA”), company name (“NVIDIA Corp”), or CIK
daysnumbernoLook back period in days (default: 365)
limitnumbernoMax filings to return (default: 20, max 200)
plan_flagsnumbernoHow many of the newest filings to read for the Rule 10b5-1 plan flag (one SEC request each; default 5, max 25, 0 to skip). Older rows carry plan_flag_status “not_fetched”.

Example call

Arguments

{
  "ticker": "NVDA",
  "days": 30
}

curl

curl -X POST https://gateway.pipeworx.io/insider-trading/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"insider_trades","arguments":{"ticker":"NVDA","days":30}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('insider_trades', {
  "ticker": "NVDA",
  "days": 30
});

More examples

{
  "ticker": "AAPL",
  "days": 365,
  "limit": 50
}

Response shape

Always returns: ticker, total_form4_filings, period, filings

FieldTypeDescription
tickerstringStock ticker in uppercase
total_form4_filingsnumberNumber of Form 4 filings RETURNED in filings — always equals filings.length
periodstringLook back period description
filingsarray
matched_form4_filingsnumberNumber of Form 4 filings matching upstream for this company and window, which may exceed the number returned
cikstringSEC CIK the ticker resolved to (unpadded)
company_namestringCanonical SEC registrant name
truncatedbooleanTrue when more filings matched upstream than were returned; raise limit to see them
matched_bystringHow the company was matched: ticker, cik or company_name
Full JSON Schema
{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Stock ticker in uppercase"
    },
    "total_form4_filings": {
      "type": "number",
      "description": "Number of Form 4 filings RETURNED in `filings` — always equals filings.length"
    },
    "period": {
      "type": "string",
      "description": "Look back period description"
    },
    "filings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "Filing date"
          },
          "filer": {
            "type": "string",
            "description": "Company or insider name"
          },
          "form": {
            "type": "string",
            "description": "Form type (4)"
          },
          "accession": {
            "type": "string",
            "description": "SEC accession number"
          },
          "filing_url": {
            "type": "string",
            "description": "URL to SEC filing document"
          },
          "rule_10b5_1_plan": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Rule 10b5-1 trading-plan checkbox on the Form 4: true = ticked, false = explicitly unticked, null = filing predates the field (before April 2023), not fetched or unreadable; see plan_flag_status"
          },
          "plan_adoption_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Plan adoption date (YYYY-MM-DD) parsed from the filer's footnote, when stated"
          },
          "plan_footnotes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Footnote texts in the filing that mention Rule 10b5-1"
          },
          "plan_flag_status": {
            "type": "string",
            "enum": [
              "read",
              "predates_field",
              "unavailable",
              "not_fetched"
            ],
            "description": "read = flag taken from the filing; predates_field = filing has no checkbox; unavailable = document could not be read; not_fetched = beyond the plan_flags window"
          }
        },
        "required": [
          "date",
          "filer",
          "form",
          "accession",
          "filing_url"
        ]
      }
    },
    "matched_form4_filings": {
      "type": "number",
      "description": "Number of Form 4 filings matching upstream for this company and window, which may exceed the number returned"
    },
    "cik": {
      "type": "string",
      "description": "SEC CIK the ticker resolved to (unpadded)"
    },
    "company_name": {
      "type": "string",
      "description": "Canonical SEC registrant name"
    },
    "truncated": {
      "type": "boolean",
      "description": "True when more filings matched upstream than were returned; raise `limit` to see them"
    },
    "matched_by": {
      "type": "string",
      "description": "How the company was matched: ticker, cik or company_name"
    }
  },
  "required": [
    "ticker",
    "total_form4_filings",
    "period",
    "filings"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the insider-trading pack
{
  "mcpServers": {
    "insider-trading": {
      "url": "https://gateway.pipeworx.io/insider-trading/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 15, 2026