insider signal — Empowering retail investors with…

Pitch

Description

Comments

About this project

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.