Insider flow report (Form 4 transactions)

Name a US ticker and get one cited insider-flow report: every Form 4 against the company in the window with the actual transactions parsed from the filings - open-market buys and sales (who, when, how much, at what price) separated from awards, option exercises and tax withholding - aggregated per insider and as a net flow, with a grounded signal read and a downloadable transactions appendix. Send POST /v1/insider-report with no required fields (3 optional) and pay $0.60 per call over x402 with USDC on an EVM chain. It returns a JSON object with report, company, ticker, cik, sources and 2 more.

SEC EDGAR data, not investment advice. USDC (x402/MPP) or card (Stripe). Not cached.

Category: LLM gateway · Tags: insider form-4 sec edgar trades officers directors report

TRY IN PLAYGROUND →

Parameters

Example request

curl -i -X POST https://agent402.tools/v1/insider-report \
  -H "Content-Type: application/json" \
  -d '{"ticker":"AAPL","days":90}'

Without payment this returns HTTP 402 Payment Required with the exact price for insider-report; any x402 v2 or MPP client pays it and retries.

Example response

{
  "report": "# Insider Flow Report: Example Corp (EXMP)\n\n**2026-05-24 to 2026-08-22** · 6 Form 4 filings read · 1 open-market buy ($240,000) · 3 open-market sales ($1,850,000)\n\n## Snapshot\n...\n\n## Sources\n[1] Form 4 filed 2026-08-18 by Example Officer - SEC EDGAR - https://www.sec.gov/Archives/edgar/data/0000000000/000000000000000000/form4.xml",
  "company": "Example Corp",
  "ticker": "EXMP",
  "cik": "0000000000",
  "sources": [
    {
      "n": 1,
      "title": "Form 4 filed 2026-08-18 by Example Officer - SEC EDGAR",
      "url": "https://www.sec.gov/Archives/edgar/data/0000000000/000000000000000000/form4.xml"
    }
  ],
  "tables": [
    {
      "name": "transactions",
      "label": "Form 4 transactions",
      "columns": [
        "Date",
        "Filed",
        "Insider",
        "Role",
        "Security",
        "Code",
        "Kind",
        "Shares",
        "Price",
        "Value (USD)",
        "Owned after",
        "10b5-1",
        "Filing"
      ],
      "rows": [
        [
          "2026-08-16",
          "2026-08-18",
          "Example Officer",
          "Chief Financial Officer",
          "Common Stock",
          "S",
          "open-market sale",
          "5000",
          "120.5",
          "602500",
          "41000",
          "noted",
          "https://www.sec.gov/Archives/edgar/data/0000000000/000000000000000000/form4.xml"
        ]
      ]
    }
  ],
  "meta": {
    "tier": "insider-report",
    "company": "Example Corp",
    "ticker": "EXMP",
    "window_days": 90,
    "filings_read": 6,
    "transactions": 9,
    "open_market_buys": 1,
    "buy_usd": 240000,
    "open_market_sells": 3,
    "sell_usd": 1850000,
    "net_open_market_usd": -1610000,
    "sources_cited": 7,
    "synthesis_model": "anthropic/claude-opus-5"
  }
}

From an MCP client

catalog.call {
  "slug": "insider-report",
  "params": {
    "ticker": "AAPL",
    "days": 90
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for insider-report; the stdio package pays it from a wallet or from AGENT402_CREDITS_KEY. Local install: npx -y agent402-mcp.

Errors and behavior

• Every field is optional. An input the tool rejects returns an HTTP 4xx whose body carries error, tool, expected, required and example.
• A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement is cancelled when the tool fails.
• Wallet-only: this tool runs a model, so it has no proof-of-work tier. A prepaid card-credits key (Authorization: Bearer a402_...) also pays it.
• Model-backed: the answer is generated by a model, so the same input can produce different wording.
• Long-running: payment settles after the work finishes, so only EVM exact payments are offered.
• A GET or HEAD to /v1/insider-report returns the same 402 quote, so the price can be read without a body.
• An Idempotency-Key header makes a retried paid call replay the first 200 instead of charging again (an answer larger than 1 MB and a streamed response are not replayed).

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls?.(false); // keep your own spending ceiling in code
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/v1/insider-report", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "ticker": "AAPL",
    "days": 90
  }),
});

Related tools