insider-signal streamlines the process of tracking insider trading activities by aggregating data from multiple public sources into a single command-line interface. Designed for retail investors and developers, it simplifies access to critical trading signals without the hassle of checking multiple sites or dealing with paywalls.
insider-signal is a command-line interface (CLI) tool designed to provide multi-source insider trading intelligence specifically for retail investors. It aggregates insider trading disclosures from various U.S. government sources into a single, organized signal layer, enabling users to access essential trading data with just one command.
Value Proposition
Currently, there is no equivalent open-source aggregator available for retail developers who wish to create algorithmic trading systems or tools focused on financial transparency. Most users find themselves manually checking multiple websites for insider trading information, which often leads to duplicated efforts and a lack of standardized scoring. insider-signal addresses this gap effectively by simplifying the data gathering process, ensuring that all necessary information is easily retrievable and organized.
Data Sources
The tool compiles insider trading data from four public sources, categorized into tiers:
| Tier | Who | Source | Data Type |
|---|---|---|---|
| T1 | President / Vice President | TrumpTracker | OGE filings |
| T2 | Cabinet secretaries | TrumpTracker | OGE filings |
| T3 | Congress (House + Senate) | CapitalTrades + Gov JSON feeds | STOCK Act |
| T4 | CEOs, CFOs, Directors | OpenInsider + UnusualWhales | SEC Form 4 |
These sources are all public government disclosures, meaning no paywalls and no API keys are required for access.
Usage Examples
insider-signal offers various commands to cater to different user needs. Here are a few examples of how to utilize the tool:
# Get a full 4-tier report for a specific ticker
insider-signal scan NVDA
# Access smart money sweeps — trades above $1M from all sources
insider-signal scan --smart-money
# View the latest trades from the Trump cabinet only
insider-signal admin
# Retrieve trades linked to specific individuals
insider-signal person scott-bessent
insider-signal person nancy-pelosi
Signal Scoring
To enhance the utility of the trades, each trade is assessed based on five scoring dimensions:
| Dimension | Logic |
|---|---|
| Tier weight | Cabinet = 8.0x, Politician = 5.0x, Corporate = 3.0 |
| Action | BUY = 1.0x multiplier, SELL = 0.3x |
| Trade size | $1M+ = +3.0, $10M+ = +4.0 |
| Disclosure lag | Late filing incurs penalties up to -2.0 |
| 10b5-1 penalty | Pre-scheduled sales incur a penalty of -3.0 |
An additional convergence bonus (+3.0) is applied when the same ticker appears across two or more sources within the same timeframe, indicating stronger signals.
Project Structure
The project is organized for efficient development and use:
insider_signal/
├── sources/
│ ├── openinsider.py # SEC Form 4
│ ├── capitoltrades.py # STOCK Act — House, Senate
│ ├── unusualwhales.py # Options flow + insider cross-ref
│ └── trumptracker.py # Executive branch OGE filings
├── models.py # Trade dataclass, Tier, Action enums
├── scoring.py # Signal scoring + convergence engine
└── cli.py # Click CLI — scan, admin, person
Contribution
Contributions are welcome, and potential contributors are encouraged to open an issue prior to making major changes.
No comments yet.
Sign in to be the first to comment.