Skip to content

Releases: undeemed/SEC-Tracker

v1.0.0

03 Oct 08:42
@undeemed undeemed
alpha
1d19933

Choose a tag to compare

View all tags
v1.0.0 Latest
Latest

SEC Filing Tracker v1.0.0

🚀 Initial Release - Multi-Company SEC Filing Analysis Platform

Release Date: January 2025
Version: 1.0.0
Status: Pre-Production

📋 Overview

The SEC Filing Tracker is a comprehensive Python-based platform for tracking, analyzing, and monitoring SEC filings across any publicly traded company. This initial release provides robust multi-company support with intelligent caching, AI-powered analysis, and flexible command-line interface.

✨ Key Features

🎯 Multi-Company Support

  • Universal ticker symbol support (works with any publicly traded company)
  • Smart CIK lookup and validation
  • Efficient multi-company tracking with state management
  • File organization: sec_filings/[TICKER]/ structure

🧠 AI-Powered Analysis

  • OpenRouter integration for multiple AI models
  • Flexible model switching with slot management
  • Custom model input support
  • Financial document analysis and insights
  • Cost-effective free models included

⚡ Smart Caching System

  • Global Form 4 Cache: Company-agnostic insider trading cache
  • Company-Specific Cache: Per-company tracking cache
  • Incremental updates (only fetches new filings)
  • Accession number deduplication
  • Never-fetch-same-filing optimization

📊 Form 4 Insider Trading

  • Real-time insider transaction tracking
  • Date range filtering (-tp MM/DD - MM/DD)
  • Planned transaction hiding (--hide-planned)
  • Transaction grouping and summarization
  • Multiple companies analysis

🔧 Comprehensive CLI

  • Intuitive command system via run.py wrapper
  • Command transparency (file mapping documentation)
  • Error handling and user guidance
  • Interactive setup and configuration

🛠️ Core Commands

Primary Tracking

python run.py track AAPL          # Smart company tracking
python run.py form4 TSLA 50       # Insider trading analysis
python run.py latest 100          # Recent insider transactions

AI Analysis

python run.py analyze AAPL --forms 10-K     # Financial analysis
python run.py model -switch                 # AI model management

Cache Management

python run.py latest 50 --refresh           # Refresh caches
python run.py model -switch -slot 1         # Model slot system

🏗️ Architecture Highlights

File Structure

  • Runner: run.py - Command orchestration
  • Core Tracking: sec_filing_tracker.py - Main multi-company logic
  • Form 4 Analytics: track_form4.py & latest_form4.py - Insider trading
  • AI Integration: filing_analyzer.py - Document analysis
  • Utilities: Cache management, CIK lookup, API helpers

Smart Features

  • Never Fetch Twice: Accession number deduplication
  • Incremental Updates: Only new filings since last run
  • Two-Type Caching: Global vs company-specific strategies
  • Model Slots: Save/load AI model configurations
  • State Persistence: Maintains company tracking state

🎯 Target Users

  • Financial Analysts: Track filing changes and insider activity
  • Investors: Monitor portfolio companies for insider transactions
  • Researchers: Analyze SEC filing patterns and trends
  • Developers: Extensible platform for financial data analysis

📈 Performance Features

  • Efficient: Only fetches new filings (track skip existing)
  • Fast: Uses latest filings cached from recent runs (latest)
  • Smart: Company-specific caches prevent redundant downloads (form4)
  • Scalable: Multi-company support with efficient file organization

🔒 Security & Reliability

  • SEC Compliance: Respects 10 requests/second rate limits
  • API Safety: Environment variable storage for credentials
  • Error Handling: Graceful fallbacks and user guidance
  • Data Integrity: Accession number validation and deduplication

📚 Documentation

  • Comprehensive README: Complete command reference and workflows
  • Command Mapping: Clear file-to-command relationships
  • Troubleshooting: Common issues and solutions
  • Model Guide: AI model selection and management
  • Cache Documentation: Two-tier caching system explanation

🚧 Future Potential Roadmap

  • Trade Analysis: Feed the form summeries back into LLM for final inference
  • Data Export: CSV/Excel export options
  • Web Dashboard: Browser-based interface
  • API Endpoints: REST API for programmatic access

📦 Installation & Setup

# Dependencies
pip install requests tiktoken openai python-dotenv tqdm

# Basic usage
python run.py track AAPL

# Full setup (guided)
python run.py update-key  # Configure API keys
python run.py model -switch  # Select AI model

🎉 What Makes This Special

It's a comprehensive platform that:

  1. Learns as it runs: Caches intelligently, never repeats work
  2. Adapts to any company: Universal ticker support with smart validation
  3. Provides AI insights: Multiple models for financial document analysis
  4. Simplifies complexity: One command (track) handles everything
  5. Scales efficiently: Multi-company support without performance loss
Assets 2
Loading