How frigomia/trade-agent works
Trade Agent is an advisory-only trading assistant: users review portfolio and watchlist analysis, then approve or dismiss recommendations; any resulting trade is placed manually outside the system. The graph follows the dashboard-to-API path and shows analysis, discovery, portfolio planning, and supporting account/data services. The README documents several capabilities whose implementation was not sampled; those appear as subsystem nodes, with only documented or indexed relationships connected. Some backend routes and domain stages are unsampled, so their internal call paths are intentionally not inferred.
Main entry points: agents Analysis agents · client.ts API client · main.py FastAPI app · discover.py Watchlist research
Components 27
User dashboard
- Dashboard
frontend/app/(shell)/today/page.tsx - Discover UI
frontend/app/(shell)/discover/page.tsx - Portfolio UI
frontend/app/(shell)/portfolio/page.tsx - Portfolio chat
frontend/app/(shell)/chat/page.tsx - API client
frontend/lib/api/client.ts
API and identity
- FastAPI app
backend/app/main.py - Authentication
backend/app/auth/deps.py - User administration
backend/app/admin/service.py
Research and decisions
- Watchlist research
backend/app/routers/discover.py - Opportunity discovery
backend/app/discovery - Analysis agents
backend/app/agents - Recommendations
backend/app/analysis/recommend.py - Research memory
backend/app/memory - Signal backtests
backend/app/backtest/engine.py
Portfolio workflows
- Portfolio API
backend/app/routers/portfolio.py - Contribution planner
backend/app/plans.py - Manual order tracking
backend/app/trades.py - Recurring investments
backend/app/recurring.py - Telegram notices
backend/app/telegram.py
Data and operations
- Database access
backend/app/db.py - Application records
backend/app/models.py - Postgres and pgvector
- Redis
backend/app/redis_client.py - Supabase Auth
Other components
- Investor
- Anthropic Claude
- Telegram service
Connections 27
- Investor → Dashboard: reviews
README.md - Investor → Discover UI: browses
README.md - Investor → Portfolio UI: manages
README.md - Investor → Portfolio chat: asks
README.md - Dashboard → API client: requests data
- Discover UI → API client: requests data
- Portfolio UI → API client: requests data
- Portfolio chat → API client: requests chat
- API client → FastAPI app: calls API
README.md - FastAPI app → Authentication: authenticates requests
backend/app/main.py - FastAPI app → Watchlist research: registers routes
backend/app/main.py - FastAPI app → Portfolio API: registers routes
backend/app/main.py - User administration → Supabase Auth: manages accounts
backend/app/admin/service.py - Watchlist research → Analysis agents: starts research
backend/app/routers/discover.py - Watchlist research → Opportunity discovery: uses company jobs
backend/app/routers/discover.py - Opportunity discovery → Analysis agents: uses market data
backend/app/discovery/admit.py - Analysis agents → Anthropic Claude: requests analysis
- Analysis agents → Redis: claims search budget
backend/app/agents/research.py - Signal backtests → Recommendations: simulates signals
backend/app/backtest/engine.py - Portfolio API → Database access: reads and writes
- Contribution planner → Manual order tracking: creates trackable orders
README.md - Recurring investments → Manual order tracking: logs placed buys
backend/app/recurring.py - Telegram notices → Telegram service: sends notices
README.md - Database access → Postgres and pgvector: opens sessions
backend/app/db.py - Database access → Application records: uses records
backend/app/db.py - Application records → Postgres and pgvector: maps data
backend/app/models.py - Analysis agents → Research memory: uses long-term memory