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:

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:

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.