Zerodha Trading Bot

Zerodha Trading Bot

A Node.js-based trading bot that integrates with the Zerodha trading platform using the Model Context Protocol (MCP) for automated trading operations.

Features

• Automated stock trading through Zerodha platform
• Session management and token handling
• Portfolio management
• Buy and Sell operations
• Real-time portfolio tracking

Prerequisites

• Node.js (v14 or higher)
• Zerodha Trading Account
• API Key and Secret from Zerodha

Installation

1. Clone the repository:

2. Install dependencies:

3. Configure your Zerodha credentials:
   • Open backend/index.js
   • Replace apiKey and apiSecret with your Zerodha credentials

Project Structure

Available Tools

The bot provides the following MCP tools:

1. Generate-Session
   • Generates a new session token using request token
   • Required parameter: requestToken
2. Buy-Stock
   • Places a buy order for specified stock
   • Parameters:
     • stock: Stock symbol
     • qty: Quantity to buy
3. Sell-Stock
   • Places a sell order for specified stock
   • Parameters:
     • stock: Stock symbol
     • qty: Quantity to sell
4. Show-Portfolio
   • Displays current portfolio holdings
   • No parameters required

Usage

1. Start the server:

2. The server will start and listen for MCP commands through stdio transport.

Security Notes

• Never commit your API credentials to version control
• Keep your apiSecret secure and private
• Use environment variables for sensitive data in production

Error Handling

The bot includes comprehensive error handling for:

• Authentication failures
• Trading operation errors
• Network issues
• Invalid parameters

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request

License

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

Disclaimer

This trading bot is for educational purposes only. Use at your own risk. Always test thoroughly before using with real money.