README.md

pyPortMan 📊💼

Python Zerodha Multi-Account Portfolio Management Software (Jupyter Notebook)

pyPortMan is a powerful tool designed to help you manage multiple Zerodha trading accounts effortlessly. With automated GTT (Good Till Triggered) order placement and portfolio tracking, it's perfect for traders and investors looking to streamline their workflow and optimize their trading strategies across multiple accounts.

🌟 Key Features

• 📈 Multi-account management for Zerodha
• 🤖 Automated GTT order placement
• 📊 Real-time portfolio tracking across all accounts
• 💹 Percentage-based allocation for each stock
• 📱 Telegram integration for instant alerts
• 🔒 Secure handling of account credentials
• 📉 Risk management through automated stop-loss and target orders

🛠️ Installation

1. Clone the repository:

   git clone https://github.com/hemangjoshi37a/pyPortMan.git
   cd pyPortMan

2. Install required dependencies:

   pip install -r requirements.txt

3. Set up your Zerodha authentication:

   • Open auth_info.xlsx
   • Add your Zerodha credentials for each account (User ID, Password, PIN, API Key if applicable)
   • Ensure you keep this file secure and do not share it

🏃‍♂️ Quick Start

1. Start the Jupyter Notebook:

   jupyter notebook hjOpenTerminal.ipynb

2. Configure your stock list:

   • Open stocks.xlsx
   • Add the stocks you want to trade, including Symbol, Percentage Allocation, Buy Price, Sell Price, and Stop Loss

3. Run all cells in hjOpenTerminal.ipynb

4. Monitor your portfolio and GTT orders in real-time through the Jupyter Notebook interface!

📖 How It Works

1. Initial Setup:

   • The software securely reads your Zerodha authentication details from auth_info.xlsx.
   • It loads your trading preferences and stock list from stocks.xlsx.

2. GTT Placement:

   • Based on your specifications, pyPortMan automatically places GTT orders for each stock across all accounts.

3. Buy-Sell Cycle:

   • Initial GTT buy orders are placed at your specified prices.
   • When a buy order is triggered, a corresponding sell GTT is automatically placed.
   • All transactions respect the percentage allocation you've set for each stock and account.

4. Real-Time Monitoring:

   • The Jupyter Notebook interface provides live updates on your portfolio status, open orders, and account balances.

🔧 Advanced Usage

Customizing Allocations

In stocks.xlsx, you can set custom percentage allocations for each stock. For example:

Symbol	Percent	Buy Price	Sell Price	Stop Loss
RELIANCE	10	2000	2100	1950

This will allocate 10% of the available funds in each account for RELIANCE stock, with a buy order at 2000, a sell target at 2100, and a stop loss at 1950.

Risk Management

pyPortMan allows you to set stop-loss orders alongside your target sell orders. This helps in automating your risk management strategy across all accounts.

Telegram Alerts

To set up Telegram alerts:

1. Create a Telegram bot and obtain the API key
2. Add your Telegram chat ID and bot API key to config.py
3. Customize alert preferences in the configuration file

🔍 Troubleshooting

• Authentication Issues: Ensure your Zerodha credentials in auth_info.xlsx are correct and up-to-date.
• Order Placement Failures: Check your account balance and stock list for any discrepancies.
• Jupyter Notebook Errors: Make sure all required libraries are installed and up-to-date.

🤝 Contributing

We welcome contributions to improve pyPortMan! Please see our Contributing Guidelines for more details on how to submit pull requests, report issues, or suggest enhancements.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgements

• Zerodha Kite API for providing the trading interface
• Jugaad Trader for inspiration and some code foundations

📫 How to reach me | Contact Information

💖 Support the Project

If you find pyPortMan helpful for your trading activities, consider supporting the project:

Your support helps us maintain and improve pyPortMan, ensuring it remains a valuable tool for the trading community!