ilia/POTE

ilia 204cd0e75b Initial commit: POTE Phase 1 complete

- PR1: Project scaffold, DB models, price loader
- PR2: Congressional trade ingestion (House Stock Watcher)
- PR3: Security enrichment + deployment infrastructure
- 37 passing tests, 87%+ coverage
- Docker + Proxmox deployment ready
- Complete documentation
- Works 100% offline with fixtures

2025-12-14 20:45:34 -05:00

1.8 KiB

Raw Blame History

🆓 Free Testing Quick Reference

TL;DR: You can test everything for $0

Already Working (PR1 ✅)

Price data: yfinance (free, unlimited)
Unit tests: Mocked data in tests/ (15 passing tests)
Coverage: 87% without any paid APIs

For PR2 (Congressional Trades) - FREE Options

Best Option: House Stock Watcher 🌟

# No API key needed, just scrape their public JSON
curl https://housestockwatcher.com/api/all_transactions

Cost: $0
Rate limit: None (reasonable scraping)
Data: Live congressional trades (House + Senate)
Quality: Community-maintained, very reliable

Backup: Quiver Quantitative Free Tier

# Sign up for free at quiverquant.com
# Add to .env:
QUIVERQUANT_API_KEY=your_free_key

Cost: $0
Rate limit: 500 API calls/month (enough for testing)
Data: Congress + Senate trades + insider trades

Testing Strategy (Zero Cost)

# 1. Unit tests (always free, use mocks)
make test

# 2. Integration tests with fixtures (real data shape, no network)
pytest tests/ -m integration

# 3. Live smoke test with free APIs
python scripts/fetch_house_watcher_sample.py  # We'll build this in PR2

What You DON'T Need to Pay For

❌ QuiverQuant Pro ($30/mo) - free tier is enough for dev/testing
❌ Financial Modeling Prep paid tier - free tier works
❌ Any paid database hosting - SQLite works great locally
❌ Any cloud services - runs 100% locally

When You MIGHT Want Paid (Way Later)

Production-grade rate limits (thousands of requests/day)
Historical data >2 years back
Multiple concurrent users on a dashboard
Commercial use (check each API's terms)

For personal research? Stay free forever. 🎉

See docs/06_free_testing_data.md for full details.

1.8 KiB Raw Blame History