An automated trading application built with Groww API that enables users to create profit from trading through condition-based buy/sell strategies.
- 🔐 Multiple authentication methods (Access Token, API Key/Secret, TOTP)
- 📊 Real-time market data and portfolio tracking
- 🤖 Condition-based automated trading
- 📈 Order management (Buy/Sell)
- 💼 Position and holdings management
- 🎯 Strategy builder with multiple conditions
This is a monorepo containing:
packages/backend- Node.js/Express API server for Groww API integrationpackages/frontend- React/Vite web applicationpackages/shared- Shared types and utilitiespackages/trading-engine- Core trading logic and condition evaluation
- Node.js >= 18.0.0
- A Groww account with Trading API subscription
- API credentials from Groww Trading API
npm install- Copy
.env.exampleto.envin the backend package - Add your Groww API credentials
Run both backend and frontend:
npm run devOr run individually:
# Backend only
npm run dev --workspace=backend
# Frontend only
npm run dev --workspace=frontendThe app supports three authentication methods:
- Access Token - Direct token (expires daily at 6:00 AM)
- API Key + Secret - Requires daily approval
- API Key + TOTP - Uses TOTP code from authenticator app
- Create custom trading strategies with multiple conditions
- Automated order placement based on market conditions
- Real-time portfolio and position tracking
- Order history and trade analysis
Comprehensive documentation is available in the docs/ directory:
- Getting Started - Setup, authentication, and basic usage guide
- Deployment and Operations - Production deployment, Docker, CI/CD, backup, and load testing
- Monitoring and Observability - Monitoring, metrics, alerting, APM, and Grafana setup
- Features and Integrations - Real-time updates, Redis, caching, risk management, strategy templates, technical indicators, CDN, and AI integration
- Development and Reference - Testing, security, database optimization, production readiness, and handover checklist
MIT