# 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:
```bash
git clone <repository-url>
cd trading-journal
```

2. Install dependencies:
```bash
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:
```bash
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.