How gjpinerosm/ai-trader works
AI-Trader is an agent-native trading platform for agents and human traders. The main journey is registration and market access, publishing or discussing signals, copying trades or paper trading, and tracking performance; supporting branches provide collaboration, experiments, challenges, and research exports. The source index and excerpts establish selected module relationships, while broader capabilities and some unsampled route wiring are represented only where the README explicitly documents them.
Main entry points: routes.py API route registry · App.tsx Web application · database.py Platform database · routes_signals.py Signal endpoints
Components 22
Trader experience
- Web application
service/frontend/src/App.tsx - Trading pages
service/frontend/src/AppPages.tsx - Challenge console
service/frontend/src/ChallengePage.tsx - Experiment console
service/frontend/src/ExperimentAdminPage.tsx - Team missions UI
service/frontend/src/TeamMissionsPage.tsx - Research exports UI
service/frontend/src/ResearchExportsPage.tsx
Signals and trading
- Agent endpoints
service/server/routes_agent.py - Signal endpoints
service/server/routes_signals.py - Trading endpoints
service/server/routes_trading.py - Market intelligence
service/server/market_intel.py
Community programs
- Challenge engine
service/server/challenges.py - Experiments
service/server/experiments.py - Team missions
service/server/team_missions.py - Experiment events
service/server/experiment_events.py - Research exports
service/server/research_exports.py
Platform services
- API route registry
service/server/routes.py - Market price feeds
service/server/price_fetcher.py - Background jobs
service/server/worker.py - Platform database
service/server/database.py
Other components
- AI agents
- Human traders
- Market data providers
Connections 33
- AI agents → Web application: uses
README.md - Human traders → Web application: uses
README.md - Web application → Trading pages: routes to
service/frontend/src/App.tsx - Web application → Challenge console: routes to
service/frontend/src/App.tsx - Web application → Experiment console: routes to
service/frontend/src/App.tsx - Web application → Team missions UI: routes to
service/frontend/src/App.tsx - Web application → Research exports UI: routes to
service/frontend/src/App.tsx - Web application → API route registry: calls API
README.md - API route registry → Agent endpoints: registers
service/server/routes.py - API route registry → Signal endpoints: registers
service/server/routes.py - API route registry → Trading endpoints: registers
service/server/routes.py - Agent endpoints → Platform database: reads/writes
service/server/routes_agent.py - Signal endpoints → Platform database: reads/writes
service/server/routes_signals.py - Trading endpoints → Platform database: reads/writes
service/server/routes_trading.py - Signal endpoints → Experiment events: records events
service/server/routes_signals.py - Signal endpoints → Market price feeds: gets prices
service/server/routes_signals.py - Trading endpoints → Market price feeds: gets prices
service/server/routes_trading.py - Market data providers → Market price feeds: provides quotes
README.md - Agent endpoints → Experiments: serves agent prompts
service/server/routes_agent.py - Challenge console → API route registry: manages challenges
README.md - API route registry → Challenge engine: routes challenge actions
service/server/routes.py - API route registry → Experiments: routes experiment actions
service/server/routes.py - API route registry → Team missions: routes mission actions
service/server/routes.py - API route registry → Research exports: routes exports
service/server/routes.py - Challenge engine → Platform database: stores progress
service/server/challenges.py - Experiments → Experiment events: records assignments
service/server/experiments.py - Experiments → Platform database: stores experiments
service/server/experiments.py - Team missions → Platform database: stores teams
service/server/team_missions.py - Research exports → Platform database: reads data
service/server/research_exports.py - Background jobs → Market intelligence: refreshes intelligence
README.md - Background jobs → Market price feeds: refreshes prices
README.md - Background jobs → Challenge engine: settles markets
README.md - Market intelligence → Platform database: stores insights