Insider radar
Surface ownership-change signal: SEC Form 4 trades (officers, directors, 10% owners trading their own stock) and 13F moves (funds and foundations adjusting stakes). AlphaAI templates each filing into a relevance-scored news row, so the read-across is already done.
Steps
- Single ticker. Call
alphai_insider_news(ticker="<SYM>"). If the user wants only the strongest signal, raise the floor withmin_relevance=8. - Watchlist. Call
alphai_insider_news(ticker=...)once per name. If the user gave none, callalphai_insider_news()unfiltered for the broad tape. - Time-box on request. For "this week" / "since earnings", pass
from_date(ISO, UTC). Paginate withcursoronly if they ask for more. - Distinguish buys from sells. Open-market purchases by insiders are the higher-signal event; routine 10b5-1 scheduled sales and option-exercise sales are noise more often than not. Call that out — don't treat every sale as bearish.
Output
- Notable buys — insider purchases first: ticker · who/role · size if given · relevance. These are what most users actually want.
- Notable sells — flag whether each looks like a discretionary sale vs a scheduled/10b5-1 or option-related sale, where the feed says.
- Institutional (13F) — any fund stake increases/trims worth a mention.
- Read — one line: is the cluster leaning accumulation or distribution, or is it just routine?
Guardrails
- An insider sale is not automatically bearish (taxes, diversification, scheduled plans). Say what the filing shows; don't over-read it.
- One filing can span several tranches sharing a row — report the event, not a count of line items.
- Lead with
relevance_score; "no notable insider activity in the window" is a valid, useful answer. - News, not advice.