Insider flow report (Form 4 transactions)
POST /v1/insider-reportName a US ticker and get one cited, model-backed 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 or MPP. 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. Takes up to 3 minutes to answer: send the paid call with "Prefer: respond-async" to get a job link at once and collect the answer from it (on x402 the payment settles only on a delivered result), or with "Prefer: wait=180" and keep the connection open for at least 210 seconds, because a client that disconnects first loses the answer. A paid call with neither header is answered 400 before any payment is taken.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ticker | string | no | US stock ticker, e.g. AAPL (or pass cik). |
cik | string | no | SEC CIK of the company (alternative to ticker). |
days | number | no | Lookback window in days, 7-365 (default 90). |
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.
Watch a call get paid
POST /v1/insider-report$0.60 USDCPAYMENT-SIGNATUREon 11 chains200 OKAgent402-ReceiptEd25519Example 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"
}
}| Field | Type | Always present | In the example |
|---|---|---|---|
report | string | yes | # Insider Flow Report: Example Corp (EXMP) **2026-05-24 to 2026-08-22** · 6 ... |
company | string | yes | Example Corp |
ticker | string | yes | EXMP |
cik | string | yes | 0000000000 |
sources | array of objects | yes | 1 item in the example |
tables | array of objects | yes | 1 item in the example |
meta | object | yes | 13 fields: tier, company, ticker, window_days, filings_read and 8 more |
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 an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.14.0.
Errors and behavior
- Every field is optional. An input the tool rejects returns an HTTP 4xx whose body carries
error,tool,expected,requiredandexample. - A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement runs after the tool and only on a successful response.
- Wallet-only: this tool runs a model, so it has no proof-of-work tier. A prepaid card-credits key issued earlier (
Authorization: Bearer a402_...) also pays it. - Model-backed: the answer is generated by a model, so the same input can produce a different result.
- Long-running: payment settles after the work finishes, so x402 is offered on EVM chains only and MPP on Base, Celo or card; Tempo is not offered.
- Usually answers in about 90 seconds and takes up to 180 seconds. Send the paid call with
Prefer: respond-asyncto get202and a job link at once, then pollGET /api/jobs/{id}for its stage, progress and ETA until it has the answer; payment still settles only when the answer is ready, except a Tempo transfer sent before the call, which is repaid after on-chain proof if the run fails. To wait on the connection instead, sendPrefer: wait=180and keep it open that long. A paid call with neither header is answered400before any payment is taken. - A
GETorHEADto /v1/insider-report returns the same 402 quote, so the price can be read without a body. - An
Idempotency-Keyheader 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?.({ maxAmountPerPayment: "$0.60" }); // refuse any quote above this tool's price
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
SEC filing report (what the company just filed)
Name a US ticker and get one cited, model-backed report on what the company just filed with the SEC: every filing.
EDGAR insider trades (Form 4)
Recent Form 4 insider transactions filed against a company (officer, director, or 10% holder trades).
Ticker pack: dossier, insider flow and institutional holders
One ticker, one purchase, the full picture (model-backed).
IPO pipeline digest (S-1 + 424B4)
A deterministic digest of the IPO pipeline for a window: every 424B4 final prospectus and every S-1/F-1 registration.
LinkedIn article, ready to publish (research + copy + sized images)
Hand over a topic and get a publish-ready LinkedIn article back: grounded web research with cited sources, three.
FDA recall report (drug, food, device)
Name a drug, food, ingredient, brand or medical device and get one cited, model-backed FDA recall report: every matching.