Dhan Trading

🚀 DhanHQ 交易助理

DhanHQ 交易助理是一款基于 Model Context Protocol (MCP) 的 AI 驱动交易助手，专为 DhanHQ 经纪商打造。它实现了与 DhanHQ 交易平台的自然语言交互，用户只需通过简单的对话指令，就能轻松完成订单放置、查看投资组合以及管理交易活动等操作。

🚀 快速开始

DhanHQ 交易助理能让你通过自然语言与 DhanHQ 交易平台交互，便捷地开展各类交易活动。下面为你介绍使用前的安装与设置步骤。

✨ 主要特性

订单管理

• 普通订单（市价单/限价单）：可借助 order_placement_tool.py 完成。
• 超级订单：带有目标和止损价的订单，通过 super-order.py 进行管理。
• 收市后订单：使用 after_market_order_tool.py 可在市场收盘后下单，确保次日开盘时执行。
• 订单簿和交易历史记录访问：通过 order_book_tool.py 能访问订单簿和交易历史记录。

投资组合管理

• 持仓和头寸查看：通过 holdings_positions_tool.py 查看持仓和头寸情况。
• 头寸转换：支持将头寸从日内交易转为交割等操作。

账户信息

• 资金余额查看：使用 fund_balance_tool.py 可查看账户资金余额。
• 保证金需求计算：通过 margin_calculator_tool.py 计算保证金需求。

📦 安装指南

先决条件

• Python 3.8 或更高版本
• pip 包管理器
• DhanHQ 账户及 API 凭证

安装步骤

1. 克隆此仓库到本地：

git clone https://github.com/yourusername/dhanhq-trading-assistant.git
cd dhanhq-trading-assistant

2. 使用 pip 安装依赖项：

pip install -r requirements.txt

3. 配置您的 DhanHQ API 凭证，创建 config.ini 文件并添加以下内容：

[dhanhq]
api_key = your_api_key_here
api_secret = your_api_secret_here

💻 使用示例

基础用法

以下是一些常见的交易指令示例：

# 查看当前资金余额
/balance
# 查询股票报价
/quote TCS.NS
# 下单购买股票
/buy HDFCBANK 10 shares at limit price 500
# 设置止损订单
/sell RELAXYES 5 lots with stop loss 20%

高级用法

各工具的功能说明如下：

order_placement_tool.py

此工具用于处理普通市价单和限价单，支持买入和卖出操作。

super-order.py

该工具用于管理带有复杂目标和止损条件的超级订单，支持百分比和固定价格两种模式。

after_market_order_tool.py

允许在市场收盘后下单，确保次日开盘时执行。

fund_balance_tool.py

提供账户资金、未平仓头寸和可用保证金信息。

holdings_positions_tool.py

显示当前持仓、历史交易记录和允许的产品类型转换。

margin_calculator_tool.py

计算不同投资组合的保证金需求，并生成报告。

order_book_tool.py

访问订单历史、未成交订单和已完成交易，支持订单取消功能。

📚 详细文档

项目使用 stocks.json 文件将股票名称映射到其标识符，文件结构如下：

{
  "companies": [
    {
      "stock_code": "1333",
      "company_name": "HDFC 银行有限公司",
      "stock_name": "HDFCBANK",
      "description": "..."
    }
  ]
}

📄 许可证

本项目使用 MIT 许可证。查看 LICENSE 文件获取详细信息。

⚠️ 重要提示

此软件仅用于教育目的。使用风险自担。创建者对使用此软件造成的任何财务损失不承担责任。执行所有交易操作前请务必核实。

💡 使用建议

建议在使用前仔细阅读文档，熟悉各工具的功能和使用方法。同时，在进行实际交易操作时，先在模拟环境中进行测试，确保操作的准确性。