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

Related MCP server: Zerodha Trading Bot MCP

Prerequisites

• Node.js (v14 or higher)

• Zerodha Trading Account

• API Key and Secret from Zerodha

Installation

1. Clone the repository:

git clone <repository-url>
cd trading-journal

2. Install dependencies:

npm install

3. Configure your Zerodha credentials:

   • Open backend/index.js

   • Replace apiKey and apiSecret with your Zerodha credentials

Project Structure

├── backend/
│   ├── index.js          # Main server file with MCP tools
│   ├── trading.js        # Zerodha trading implementation
│   └── tokenManager.js   # Token management system

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:

node backend/index.js

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.