How aarearavind7/trade works
This checkout contains a community-curated public-API directory alongside a lightweight paper-trading application; the trading app is the product workflow represented here. A user interacts with the browser dashboard or API, which routes requests to account/trading, market-data, research, journal, and export features. The backend uses Alpaca for paper brokerage and market streaming, with optional public-data providers. The README mainly describes the unrelated public-API directory, so browser-to-API wiring and several unsampled runtime details are shown only where documented or clearly marked unverified.
Main entry points: api.py HTTP API · app.js Dashboard UI · alpaca_client.py Alpaca Client · service.py Trading Service
Components 23
Dashboard
- Dashboard UI
web/app.js - Chart Data
web/chart-data.js - Research UI
web/research.js - Price Alerts
web/price-alerts.js - Workspace Backup
web/workspace-backup.js
API Layer
- HTTP API
trading_app/api.py - Command Line
trading_app/cli.py
Trading and Records
- Trading Service
trading_app/service.py - Order Store
trading_app/service.py - Alpaca Client
trading_app/alpaca_client.py - Trade Journal
trading_app/journal.py - CSV Export
trading_app/csv_export.py - Benchmarking
trading_app/benchmark.py
Market and Research
- Market Stream
trading_app/market_stream.py - Public Market Data
trading_app/public_market_data.py - Stock Search
trading_app/stock_search.py - S&P 500 Catalog
trading_app/sp500_catalog.py - Financial Research
trading_app/research.py
Other components
- User
- Alpaca Services
- Yahoo Finance
- Financial Modeling Prep
- Constituent Dataset
Connections 28
- User → Dashboard UI: uses
- Dashboard UI → HTTP API: requests data
- User → Command Line: invokes
trading_app/cli.py - Command Line → Alpaca Client: creates client
trading_app/cli.py - HTTP API → Trading Service: routes trading
trading_app/api.py - HTTP API → Alpaca Client: routes broker access
trading_app/api.py - HTTP API → Market Stream: routes streaming
trading_app/api.py - HTTP API → Public Market Data: routes market data
trading_app/api.py - HTTP API → Stock Search: routes search
trading_app/api.py - HTTP API → S&P 500 Catalog: routes constituents
trading_app/api.py - HTTP API → Financial Research: routes research
trading_app/api.py - HTTP API → Trade Journal: routes journal
trading_app/api.py - HTTP API → Benchmarking: routes benchmarks
trading_app/api.py - HTTP API → CSV Export: routes export
trading_app/api.py - Trading Service → Order Store: stores reviews
trading_app/service.py - Trading Service → Alpaca Client: checks and submits
trading_app/service.py - Trade Journal → Order Store: uses SQLite connection
trading_app/journal.py - Market Stream → Alpaca Services: streams quotes
trading_app/market_stream.py - Alpaca Client → Alpaca Services: calls paper services
- Public Market Data → Yahoo Finance: fetches charts
trading_app/public_market_data.py - Stock Search → Public Market Data: searches publicly
trading_app/stock_search.py - Stock Search → Alpaca Client: filters broker assets
trading_app/stock_search.py - Financial Research → Financial Modeling Prep: fetches research
trading_app/research.py - S&P 500 Catalog → Constituent Dataset: loads membership
trading_app/sp500_catalog.py - Dashboard UI → Chart Data: renders charts
- Dashboard UI → Research UI: renders research
- Dashboard UI → Price Alerts: manages alerts
- Dashboard UI → Workspace Backup: backs up workspace