How simplyaksh18/tradelens-ai works
TradeLens is an authenticated strategy-research and auditing application. A user explores instruments and market history, computes indicators and strategy signals, then inspects forward signal outcomes, simulated backtests and performance, historical audits, and failure investigations. The API is the browser-facing entry point; documented agent/MCP capabilities are represented as a separate integration branch. Sampled engines establish the main calculation handoffs; routes and other unsampled internals are shown only where the tree and entry point support them.
Main entry points: routes API routes · strategies/engine.py Strategy evaluation · outcomes/engine.py Signal outcomes · service.py Market data service
Components 24
Web client
- Application routes
frontend/src/App.tsx - Research pages
frontend/src/pages - API client
frontend/src/api/client.ts
API and identity
- FastAPI entry
backend/app/main.py - Authentication
backend/app/auth - API routes
backend/app/api/routes
Market data
- Instrument catalogue
backend/app/instruments - Market data service
backend/app/market_data/service.py - Yahoo provider
backend/app/market_data/providers/yfinance_provider.py - Market cache
backend/app/market_data/cache.py - Data validation
backend/app/market_data/validation/validator.py
Strategy research
- Indicators
backend/app/indicators/engine.py - Strategy evaluation
backend/app/strategies/engine.py - Signal outcomes
backend/app/outcomes/engine.py - Backtesting
backend/app/backtesting/engine.py - Performance analytics
backend/app/analytics/engine.py - Strategy audits
backend/app/audit/engine.py - Failure investigation
backend/app/investigation/engine.py - Knowledge retrieval
backend/app/knowledge/retriever.py
Agent interfaces
- Agent tools
backend/app/agent/agent.py - MCP adapter/server
backend/app/mcp/server.py
Other components
- Research user
- Yahoo Finance
- MCP client
Connections 31
- Research user → Application routes: uses
- Application routes → Research pages: routes
- Research pages → API client: requests
- API client → FastAPI entry: calls API
- FastAPI entry → API routes: dispatches
- API routes → Authentication: authenticates
- API routes → Instrument catalogue: queries
- API routes → Market data service: requests data
- Market data service → Market cache: reads/writes
- Market data service → Yahoo provider: fetches
- Yahoo provider → Yahoo Finance: requests quotes
- API routes → Data validation: validates data
- Indicators → Data validation: validates input
- API routes → Indicators: requests indicators
- API routes → Strategy evaluation: requests evaluation
- Strategy evaluation → Indicators: reads series
- API routes → Signal outcomes: requests outcomes
- Signal outcomes → Strategy evaluation: reads evaluations
- API routes → Backtesting: requests backtest
- Backtesting → Strategy evaluation: reads evaluations
- API routes → Performance analytics: requests analytics
- Performance analytics → Backtesting: reads result
- API routes → Strategy audits: requests audit
- Strategy audits → Strategy evaluation: reads evaluations
- Strategy audits → Signal outcomes: reads outcomes
- API routes → Failure investigation: requests investigation
- Failure investigation → Signal outcomes: classifies outcomes
- API routes → Knowledge retrieval: retrieves knowledge
- API routes → Agent tools: invokes research
- MCP client → MCP adapter/server: calls tools
- MCP adapter/server → Agent tools: dispatches tools