股票交易机器人

一个基于Node.js的交易机器人,集成Zerodha交易平台,使用模型上下文协议(MCP)进行自动化交易操作。

  • by yogendhra9
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 yogendhra9/zerodhamcp

使用说明

Zerodha交易机器人

基于Node.js的交易机器人,使用模型上下文协议(MCP)与Zerodha交易平台集成,用于自动交易操作。

特性

  • 通过Zerodha平台自动进行股票交易
  • 会话管理和令牌处理
  • 投资组合管理
  • 买卖业务
  • 实时投资组合跟踪

先决条件

  • Node.js(v14或更高版本)
  • Zerodha交易账户
  • 来自Zerodha的API密钥和秘密

安装

  1. 克隆存储库:
git clone <repository-url>
cd trading-journal
  1. 安装依赖项:
npm install
  1. 配置您的Zerodha凭据:
    • 打开 backend/index.js
    • 替换 apiKey 和 apiSecret 使用您的Zerodha证书

项目结构

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

可用工具

机器人提供以下MCP工具:

  1. 生成会话

    • 使用请求令牌生成新的会话令牌
    • 必需参数: requestToken
  2. 购买股票

    • 为指定股票下买入订单
    • 参数:
      • stock:股票代码
      • qty:购买数量
  3. 出售股票

    • 为指定股票下卖出订单
    • 参数:
      • stock:股票代码
      • qty:待售数量
  4. 展示作品集

    • 显示当前投资组合持有量
    • 无需参数

用法

  1. 启动服务器:
node backend/index.js
  1. 服务器将通过stdio传输启动并监听MCP命令。

安全说明

  • 永远不要将您的API凭据提交到版本控制
  • 保持你的 apiSecret 安全且私密
  • 在生产中为敏感数据使用环境变量

错误处理

该机器人包括全面的错误处理功能,用于:

  • 身份验证失败
  • 交易操作错误
  • 网络问题
  • 无效参数

贡献

  1. 分叉存储库
  2. 创建功能分支
  3. 提交您的更改
  4. 推到分支
  5. 创建新的Pull请求

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

免责声明

此交易机器人仅用于教育目的。使用风险自负。在使用真钱之前,一定要彻底测试。