How fedzg/tradingsim works
TradingSim is a scheduled, Alpaca Paper-only trading worker. Its main workflow wakes at Rome-time slots, gathers broker and market data, produces analysis, and—outside the briefing slot—reviews proposals against risk constraints before execution. It also scans candidate markets for permissioned, monitoring-only watchlist additions and queues reports and alerts for Telegram. The run-loop and several subsystem calls are visible in excerpts; some capability links rely on README statements or source-index references, so unsampled implementation details are not inferred.
Main entry points: run.ts Scheduled worker · broker.ts Paper broker · market.ts Market data · order-review-context.ts Order review context
Components 22
Scheduling and orchestration
- Scheduled worker
src/run.ts - Wake schedule
src/time.ts
Trading and review
- Paper broker
src/broker.ts - Alpaca MCP client
src/mcp.ts - Analyst agents
src/agents.ts - Order review context
src/order-review-context.ts - Risk checks
src/risk.ts
Market analysis and discovery
- Market data
src/market.ts - Market indicators
src/indicators.ts - Market discovery
src/discovery.ts - Discovery feeds
src/discovery-sources.ts - Chart scenarios
src/chart-scenarios.ts - News signals
src/news-signals.ts - Feed metrics
src/efficiency-metrics.ts
State and notifications
- Runtime state
src/state.ts - Notification outbox
src/chat.ts - Notification formatting
src/notifications.ts - Telegram channel
src/telegram.ts
Other components
- Operator
- Codex CLI
- Yahoo Finance
- Telegram
Connections 30
- Operator → Scheduled worker: starts or checks
README.md - Scheduled worker → Wake schedule: uses schedule
src/run.ts - Scheduled worker → Paper broker: loads snapshot
src/run.ts - Paper broker → Alpaca MCP client: requests account data
src/broker.ts - Alpaca MCP client → Paper broker: returns tool data
src/broker.ts - Scheduled worker → Market data: loads charts and news
src/run.ts - Market data → Alpaca MCP client: requests stock bars
src/market.ts - Market data → Yahoo Finance: loads price series
src/market.ts - Scheduled worker → Feed metrics: measures feeds
src/run.ts - Scheduled worker → Analyst agents: reviews proposals
src/run.ts - Analyst agents → Codex CLI: invokes analysis
src/agents.ts - Scheduled worker → Order review context: builds review context
src/run.ts - Order review context → Market indicators: uses market evidence
src/order-review-context.ts - Order review context → Risk checks: uses risk limits
src/order-review-context.ts - Scheduled worker → Risk checks: checks and gates orders
src/run.ts - Scheduled worker → Market discovery: runs discovery
src/discovery.ts - Market discovery → Discovery feeds: scans instruments
src/discovery.ts - Discovery feeds → Market data: loads series
src/discovery-sources.ts - Discovery feeds → Market indicators: computes evidence
src/discovery-sources.ts - Scheduled worker → Chart scenarios: builds scenarios
src/run.ts - Scheduled worker → News signals: uses news signals
README.md - Scheduled worker → Runtime state: reads and writes state
src/run.ts - Paper broker → Runtime state: reads fake broker state
src/broker.ts - Scheduled worker → Notification outbox: queues report and alerts
src/run.ts - Notification outbox → Runtime state: persists outbox
src/chat.ts - Scheduled worker → Notification formatting: formats notifications
src/run.ts - Notification formatting → Paper broker: uses order data
src/notifications.ts - Notification formatting → Notification outbox: queues messages
src/notifications.ts - Telegram channel → Telegram: delivers messages
README.md - Operator → Market discovery: grants watchlist permission
README.md