insider-radar

1# Insider radar
2 
3Surface ownership-change signal: **SEC Form 4** trades (officers, directors, 10%
4owners trading their own stock) and **13F** moves (funds and foundations
5adjusting stakes). AlphaAI templates each filing into a relevance-scored news row,
6so the read-across is already done.
7 
8## Steps
9 
101. **Single ticker.** Call `alphai_insider_news(ticker="<SYM>")`. If the user
11   wants only the strongest signal, raise the floor with `min_relevance=8`.
122. **Watchlist.** Call `alphai_insider_news(ticker=...)` once per name. If the
13   user gave none, call `alphai_insider_news()` unfiltered for the broad tape.
143. **Time-box on request.** For "this week" / "since earnings", pass
15   `from_date` (ISO, UTC). Paginate with `cursor` only if they ask for more.
164. **Distinguish buys from sells.** Open-market *purchases* by insiders are the
17   higher-signal event; routine 10b5-1 scheduled sales and option-exercise sales
18   are noise more often than not. Call that out — don't treat every sale as
19   bearish.
20 
21## Output
22 
23- **Notable buys** — insider purchases first: ticker · who/role · size if given ·
24  relevance. These are what most users actually want.
25- **Notable sells** — flag whether each looks like a discretionary sale vs a
26  scheduled/10b5-1 or option-related sale, where the feed says.
27- **Institutional (13F)** — any fund stake increases/trims worth a mention.
28- **Read** — one line: is the cluster leaning accumulation or distribution, or is
29  it just routine?
30 
31## Guardrails
32…