get_signals
Retrieve cluster buy or sell signals where multiple insiders trade in the same direction, indicating stronger conviction. Filter by ticker and signal type, with paginated results.
Instructions
Cluster buy/sell signals — multiple insiders at the same company trading in the same direction within a short window, a stronger conviction signal than any single trade. Excludes 10b5-1 plan trades automatically by construction. Returns signal type, detection date, buyer/seller counts, total $ value, and the underlying transactions; pair with the generated explain_signal tool to see exactly why a given signal fired. Use get_transactions instead for raw, unaggregated trade search. Requires Business plan (a 402 upgrade_required response is returned otherwise). Paginated, max 50/page.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number. Defaults to 1. | |
| ticker | No | Filter to a specific company ticker, case-insensitive, e.g. NVDA. Omit for a market-wide scan across all companies. | |
| per_page | No | Results per page. Defaults to 20, maximum 50. | |
| cluster_buy | No | If true, return only ClusterBuy signals (multiple insiders buying together). Omit both cluster_buy and cluster_sell to return signals of either type. | |
| cluster_sell | No | If true, return only ClusterSell signals (multiple insiders selling together). Omit both cluster_buy and cluster_sell to return signals of either type. |