insider_flow
Per-issuer Form-4 insider-transaction rollup — the Flow signal. "Is insider activity at company X bullish or bearish over the last N days?" Separates discretionary open-market buys/sells (the signal) from planned 10b5-1 sales, option exercises, tax-withholding, and awards (noise). Backed by 11.7M Form 4/5 transaction lines (incl. derivative) from ~4.6M filings, mid-2003 to present, ~10-min fresh.
Returns: n_buyers / n_sellers / n_csuite_buyers / n_csuite_sellers, open_market_buy_usd / open_market_sell_usd / planned_sale_usd, net_discretionary_usd (open-market buys − sells; the one number the Flow formula consumes — planned sales are EXCLUDED because a pre-scheduled sale says nothing about what the insider thinks today), n_transactions, plan_flag_coverage, as_of_effective.
PIT-honest: keyed on filing_date (Form 4s land up to 2 business days after the trade, so trade-date keying is lookahead). as_of defaults to today. plan_flag_coverage=false means the window reaches before 2023-04 (when the SEC 10b5-1 checkbox became mandatory) — planned-vs-discretionary is less reliable there. Dollar figures aggregate the derived, price-sanitized value_usd (never raw filer totals, which reach $300T from price-column typos).
include_participants=true adds participants: the top insiders behind the numbers (by dollar value, up to participants_limit), each with insider_cik, name, title, side (buy / sell / planned_sale), value_usd, n_transactions, last filing date and up to 5 most recent accessions (SEC accession numbers) so every figure can be traced to a filing. For every row, call names_transactions(issuer_cik=...).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "insider_flow"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | PIT cutoff YYYY-MM-DD (filing_date <= as_of). Default today. | |
| ticker | No | Issuer ticker (resolved to CIK via Atlas). One of ticker / issuer_cik required. | |
| issuer_cik | No | Issuer SEC CIK. One of ticker / issuer_cik required. | |
| window_days | No | Trailing window in days (from as_of). Default 90. | |
| participants_limit | No | Max participants returned (default 10, max 50). | |
| include_participants | No | Add the top contributing insiders with CIK and accession numbers. Default false. |